home *** CD-ROM | disk | FTP | other *** search
/ Monster Media 1993 #2 / Image.iso / spread / supermac.zip / MANUAL.DOC < prev    next >
Text File  |  1993-06-14  |  60KB  |  1,210 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.        +----------------------------------------------------------------+
  11.        |(C)Copyright K.I.T.A.L. Software 1989-1992. All rights reserved.|
  12.        | (C)Copyright by Haruyasu Yoshizaki, 1991. All Rights Reserved. |
  13.        |                                                                |
  14.        |                                                                |
  15.        |              SUPER MACRO LIBRARY For LOTUS(R) 1-2-3            |
  16.        |                                                                |
  17.        |                                                                |
  18.        |                      K.I.T.A.L.  Software                      |
  19.        |                          P.O. Box 748                          |
  20.        |                      Karmiel 20100 ISRAEL                      |
  21.        |                         (972)-4-987255                         |
  22.        |                                                                |
  23.        |                                                                |
  24.        |                   U S E R ' S     M A N U A L                  |
  25.        |                                                                |
  26.        |                                                                |
  27.        |                     SHAREWARE Version 3.4                      |
  28.        |                                                                |
  29.        |       For registration fee see ORDER.TXT and INVOICE.TXT       |
  30.        |                                                                |
  31.        |            Developed and Written by Israel Kehaty              |
  32.        +----------------------------------------------------------------+
  33.  
  34.  
  35.  
  36.  
  37.                               _______
  38.                          ____|__     |                (R)
  39.                       --|       |o   |-------------------
  40.                         |   o___||_  |  Association of
  41.                         |  |       |_|  Shareware
  42.                         |__|   o   |    Professionals
  43.                       -----|   |   |---------------------
  44.                            |___|___|    MEMBER
  45.  
  46.                          Member of the ASP Since 1993
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.                                      - 2 -
  62.  
  63.  
  64.                                Table Of Contents
  65.  
  66.        1.  Welcome. . . . . . . . . . . . . . . . . . . . . . . . .     3
  67.        2.  General. . . . . . . . . . . . . . . . . . . . . . . . .     6
  68.  
  69.            2.1  Macro format and rules to add macros to the package     7
  70.  
  71.        3.  The macro library manager. . . . . . . . . . . . . . . .     8
  72.  
  73.            3.1  General . . . . . . . . . . . . . . . . . . . . . .     8
  74.            3.2  Using the macro managers (MACROMGR.WK1 & MACROMLB.WK1)  9
  75.            3.3  Using the small macro library managers. . . . . . .    11
  76.            3.4  Using the NEW_MNGR.MLB manager and the COMPILE.MLB.    11
  77.  
  78.        4.  The macro writer (MACROHLP.WK1). . . . . . . . . . . . .    13
  79.  
  80.            4.1  Using the macro writer. . . . . . . . . . . . . . .    13
  81.  
  82.        5.  The link macro (LINK.WK1). . . . . . . . . . . . . . . .    14
  83.  
  84.            5.1  Using the link macro. . . . . . . . . . . . . . . .    14
  85.            5.2  File linking information table. . . . . . . . . . .    15
  86.            5.3  Establishing or edition a link. . . . . . . . . . .    15
  87.  
  88.        6.  The word processor macro (WORDPROC.WK1). . . . . . . . .    16
  89.  
  90.            6.1  Using the word processor macro. . . . . . . . . . .    16
  91.  
  92.        7.  The search & replace macro (SCRHREPL.WK1). . . . . . . .    17
  93.  
  94.            7.1  Using the search & replace macro. . . . . . . . . .    17
  95.  
  96.        8.  The run key macro (RUNKEY2.WK1). . . . . . . . . . . . .    17
  97.  
  98.            8.1  Using the run key macro . . . . . . . . . . . . . .    17
  99.  
  100.        9.  The menu range macro (MENURANG.WK1). . . . . . . . . . .    18
  101.  
  102.            9.1  Using the menu range macro. . . . . . . . . . . . .    18
  103.  
  104.        10. The macro recorder (RECORDER.WK1). . . . . . . . . . . .    18
  105.  
  106.            10.1 Using the macro recorder. . . . . . . . . . . . . .    19
  107.  
  108.        11. Range processing macros. . . . . . . . . . . . . . . . .    19
  109.        12. Database macros. . . . . . . . . . . . . . . . . . . . .    19
  110.        13. Add-in MACROMGR.ADN macro utilities. . . . . . . . . . .    19
  111.  
  112.            13.1 The library make macros (LIBMAKE.WK1...). . . . . .    20
  113.  
  114.        14. All other macros . . . . . . . . . . . . . . . . . . . .    21
  115.        15. System requirements. . . . . . . . . . . . . . . . . . .    21
  116.  
  117.  
  118.  
  119.  
  120.                                      - 3 -
  121.  
  122.        1. WELCOME
  123.  
  124.        Thank you for taking the time to try our new productivity tools
  125.        for LOTUS 1-2-3, release 2 and up. Version 3.3 now supports the
  126.        macro library manager add-in MACROMGR.ADN of LOTUS 1-2-3 Versions
  127.        2.2/2.3/2.4 and the third dimension of versions 3.0/3.1/3.1+/3.4
  128.        and Lotus 123W 1.0/1.0a/1.1 for Windows 3/3.1.
  129.  
  130.        The SUPER MACRO LIBRARY for LOTUS 1-2-3 is a large collection of
  131.        more than 250 *.WK* macros that enhance and increase the power and
  132.        efficiency of LOTUS 1-2-3 release 2 and up, and an equally large
  133.        collection of 220 *.MLB library macros for LOTUS 2.2/2.3/2.4
  134.        created from all the *.WK1 macros that were suitable to work as
  135.        *.MLB library macros.
  136.  
  137.        Most of the macros are far more powerful and flexible than those
  138.        found in books, magazines and commercially available packages. All
  139.        these macros are just a few key strokes away using our
  140.        revolutionary MACRO LIBRARY MANAGERS (macros, themselves). Only the
  141.        MACRO LIBRARY MANAGER needs to be combined to the worksheet, the
  142.        other macros can be directly activated from the disk. The MACRO
  143.        LIBRARY MANAGER features a QUICK RUN mode that uses the disk
  144.        directory list display to POINT and SHOOT, and a SEARCH by KEYWORD
  145.        query to POINT to the matched macro description and SHOOT. Added to
  146.        the MACRO LIBRARY MANAGERS, the package features the following
  147.        unique macros:
  148.  
  149.        a. Full featured SEARCH & REPLACE SCRHREPL.WK1), which allows you
  150.           to search and replace any set of characters through any defined
  151.           range, including multiple occurrences in one cell. The macro
  152.           features: Case sensitive, Case insensitive, Replace all, or Find
  153.           and replace or skip. This macro is especially useful for release
  154.           2/2.01 users.
  155.  
  156.        b. LINK (LINK.WK1), which allows you to establish a link between
  157.           any cells/ranges of the worksheet to cells/ranges of OTHER
  158.           worksheets in the disk. Any time the worksheet is retrieved, the
  159.           macro updates the linked cells/ranges. This macro is especially
  160.           designed for release 2/2.01 users.
  161.  
  162.        c. RUN KEY (RUNKEY2.*), which allows you to activate any routine in
  163.           the worksheet using POINT and SHOOT to the range/routine names
  164.           mnemonics display list, thereby eliminating the need to use the
  165.           [Alt] + key combination to run a macro for release 2/2.01 users.
  166.  
  167.        d. MACRO WRITER (MACROHLP.WK1), which allows you to CONTINUOUSLY
  168.           write macros, text and formulas using pre-written syntax picked
  169.           from the screen display for EVERY LOTUS macro keyword or
  170.           function. The MACRO WRITER automatically "knows" when a formula
  171.           is written, and inserts it to the cell as a formula.
  172.  
  173.        e. WORD PROCESSOR (WORDPROC.WK1) with an adjustable line width and
  174.           SEARCH and REPLACE.
  175.  
  176.  
  177.  
  178.                                      - 4 -
  179.  
  180.        f. MENU RANGE (MENURANG.WK1), which allows you to define any
  181.           range as MENU RANGE and thereby overcome the eight menu title
  182.           limitation in Lotus 1-2-3 menu bar.
  183.  
  184.        g. MACRO RECORDER (RECORDER.*), which allows you to work normally,
  185.           but simultaneously records every keyboard entry in versions
  186.           2/2.01.
  187.  
  188.        h. ERROR PROOF (ERRPROOF.*), which automatically turns any
  189.           formula to an ERR proof, i.e. to display ZEROs instead of ERRs.
  190.  
  191.        i. RANGE COMBINE (RANGCOMB.*), which allows you to combine two
  192.           ranges in the same worksheet.
  193.  
  194.        j. GRAPH GROUP (GRAPHGRP.*) for release 2, which simulates the
  195.           / Graph Group new options in Lotus 1-2-3 versions 2.2/2.3/2.4.
  196.  
  197.        k. INSERT RANGE (RANGEINS.*), which allows you to open an empty
  198.           range in the middle of the worksheet and keeps all the formulas
  199.           intact, permitting partial column or row insert.
  200.  
  201.        l. DELETE RANGE (RANGDEL1.*), which allows you to delete a range in
  202.           the middle of the worksheet and keeps all formulas intact,
  203.           permitting partial column or row delete.
  204.  
  205.        m. KEEP RANGE (RANGKEEP.*), which allows you to erase the whole
  206.           worksheet EXCEPT a selected range in one operation.
  207.  
  208.        n. TRANSPOSE (TRANSPO2.* and TRANSPO3.WK3), which allows you to
  209.           transpose a range and handle all the formula references
  210.           correctly.
  211.  
  212.        Users of 1-2-3 release 2 can now enjoy most of the new features
  213.        and power of versions 2.2/2.3/2.4. For the LOTUS 2.2/2.3/2.4 user,
  214.        this package contains the following special macros that support
  215.        the MACROMGR.ADN add-in macro library manager supplied with the
  216.        LOTUS 1-2-3 versions 2.2/2.3/2.4:
  217.  
  218.        a. Two macro managers (MACROMLB.WK1 and SMALLMLB.WK1) allowing
  219.           you to use all the *.MLB macros directly from the disk, only
  220.           the macros library manager needs to be combined to the
  221.           worksheet.
  222.  
  223.           A new manager type has been added to this package which no
  224.           longer needs to be combined to the worksheet. The NEW_MNGR.MLB
  225.           macro allows you to use over 200 MLB macros using point
  226.           and shoot. This is a real breakthrough in the field of *.MLB
  227.           macro managers. Only K.I.T.A.L. Software is offering this
  228.           unique approach for macro library handling. We are the first
  229.           and only programmers to have managed to create such a manager.
  230.  
  231.           We also include a "compiler" macro COMPILE.MLB that can create
  232.           such a manager from a simple column list of macro names, which
  233.           are included in this package. You are easily create as many
  234.           managers as you like (Paragraph 3.4.1).
  235.  
  236.                                      - 5 -
  237.  
  238.  
  239.           You can always use the NEW_MNGR.MLB manager, which allows you
  240.           to operate all the *.MLB macros listed in the NEW_MNGR.PRN
  241.           ASCII file. Or you can use partial lists to save memory when
  242.           your computer is limited in memory.
  243.  
  244.           The MACROMLB.WK1 and the SMALLMLB.WK1 macros are not obsolete,
  245.           they still need less memory than the NEW_MNGR.MLB. Remember
  246.           that these two managers must be combined to the worksheet
  247.           exactly as the managers (MACORMGR.WK1 and SMALLMGR.WK1) for the
  248.           *.WK1 macros intended for users of LOTUS 2/2.01.
  249.  
  250.           The first advantage from using *.MLB macros, which can be
  251.           activated by the MACROMGR.ADN manager, is that they reside in
  252.           the memory and do not interfere with the worksheet. The second
  253.           advantage is that, if you use small library macros, you save
  254.           memory. Compared to the *.WK1 macros, the disadvantage is that
  255.           some sophisticated macros that stretch LOTUS 1-2-3 to the limit
  256.           and use special tricks to get the most out of the LOTUS 1-2-3
  257.           macro language, cannot be used inside the MACROMGR.ADN add-in.
  258.           You still need to rely on some of the *.WK1 macros.
  259.  
  260.        b. A special library creator (LIBMAKE.WK1), which allows you to
  261.           automatically create *.MLB library macros from any *.WK1 macro,
  262.           which conforms to the simple rules in section 2.2. You can
  263.           use point and shoot at the macros directory list on screen, to
  264.           combine *.WK1 macros into one *.MLB library or to combine *.MLB
  265.           macros into one large *.MLB macro and more.
  266.  
  267.           If you are using a 3-D release of LOTUS 1-2-3, this package
  268.           also supports the third dimension, in fact, all the range
  269.           process macros handle 2-D and 3-D r*anges. The macros
  270.           automatically detect which Lotus release you are using and
  271.           adapt themselves.
  272.  
  273.        This package also contains the following special utilities:
  274.  
  275.        a. Two macro managers (MACORMG3.WK3 and SMALLMG3.WK3), which allow
  276.           you to use all the *.WK* macros directly from the disk, only
  277.           the macro library manager needs to be combined to the
  278.           worksheet.
  279.        b. A special library creator (LIBMAKE3.WK1), which allows you to
  280.           automatically create *.WK3 macro libraries from the *.WK*
  281.           macros. It allows you to use point and shoot at the macros
  282.           directory list on-screen, and to combine *.WK* macros into one
  283.           *.WK3 library. Two options can be used: create a one sheet
  284.           macro library or a multiple sheet macro library.
  285.  
  286.        All *.WK1 macros have been checked and have been adapted to work
  287.        with 3-D releases of Lotus 1-2-3. A few *.WK3 macros were added to
  288.        the package and can be used only with 3-D releases of Lotus 1-2-3.
  289.        Mmany macros specifically state that they detect which Lotus
  290.        release you are using. These macros use the @INFO("release")
  291.        function to check if you are using a 3-D release or a 2-D release
  292.        of Lotus 1-2-3. If you are using a 3-D release the macro also
  293.        exploits the third dimension.
  294.  
  295.  
  296.                                      - 6 -
  297.  
  298.  
  299.        Many other macros also support the third dimension when they use
  300.        the natural Lotus functions (such as: copy, delete, move etc.)
  301.        Because the 3-D releases do not support the MACROMGR.ADN add-in
  302.        supplied with Lotus 2.2/2.3 and 2.4, the *.MLB macros cannot be
  303.        used with a 3-D release. However, the 3-D releases can have
  304.        multiple sheets and multiple files in memory, which allows us to
  305.        keep macros in separate sheets and the data in separate sheets.
  306.  
  307.        In the SUPER MACRO LIBRARY, we have minimized the common risk that
  308.        two macros may have the same range names in between themselves and
  309.        between the macros and your worksheet file. Every macro containing
  310.        more than one range name is numbered by a three digit number
  311.        attached to the range name. For example, a previously "LOOP" range
  312.        name now may be "LOOP001" in one macro, but "LOOP123" in another
  313.        macro. The result is a foolproof package that allows you to create
  314.        large macro libraries without the danger of a range name conflict.
  315.  
  316.        Bundled with this package is the completely menu driven solver and
  317.        calculator The SCIENTIFIC and ENGINEERING TOOL for LOTUS 1-2-3 as
  318.        a BONUS pack, which features: Simple arithmetic, Functions
  319.        programming, Physical units definition & conversion, Integration
  320.        and Differentiation of functions and data tables, Statistics
  321.        functions, Frequency and normal distributions, Curve fitting
  322.        (Polynomial, Exponent, Powers, Linear), Root finding of non-linear
  323.        equations, Matrix operations, Simultaneous linear equations
  324.        solver. Use the macro library managers with your already existing
  325.        macro libraries, and enjoy the new possibilities it can afford.
  326.  
  327.        NOTE: Due to a serious bug in the Lotus 123W version 1.0/1.0a for
  328.              Windows 3/3.1 the SCIENTIFIC and ENGINEERING TOOL for LOTUS
  329.              will not work correctly in 123W 1.0/1.0a. This bug was fixed
  330.              in 123W 1.1.
  331.  
  332.        2. GENERAL
  333.  
  334.        To make macro handling easier every macro is a separate file.
  335.        Because we use the MACRO LIBRARY MANAGERS (macros) developed
  336.        especially by us, there is no need to combine most of the macros,
  337.        except those macros that by nature CANNOT be used from the manager
  338.        and must be combined directly to the mother worksheet (see the
  339.        LIST2.WK1 file).
  340.  
  341.        Every macro contains the instructions for how to use it WITHOUT
  342.        the MANAGER. Additional explanation and use instructions have been
  343.        supplied for some macros, along with a few sample files allowing
  344.        you to experiment, before getting down to serious business. We
  345.        recommend that every time you use a new macro, you experiment on a
  346.        sample or backup file. You can use all the macros without the
  347.        macro manager, just use the COMBINE option of LOTUS 1-2-3, and the
  348.        built-in instructions.
  349.  
  350.  
  351.  
  352.                                      - 7 -
  353.  
  354.  
  355.        From your worksheet, place the cell pointer where you want the
  356.        macro, and use / File Combine Copy Entire-file to combine the
  357.        macro to your worksheet. Then use the built-in instructions to
  358.        define the range names and activate the macro. If you use Version
  359.        2.2, 2.3 or 2.3 you can use the *.MLB macros. Again, every macro
  360.        is a separate file and can you can activate it directly from the
  361.        disk, if you use the MACROMLB.WK1 or the SMALLMLB.WK1 macro
  362.        managers, which automatically load the desired macro into memory
  363.        and use the MACROMGR.ADN add-in to activate the macro. You need to
  364.        combine only the macro manager to the worksheet. When you start
  365.        the macro manager, you can use the custom menu bar to activate the
  366.        *.MLB macro using point and shoot.
  367.  
  368.        IMPORTANT:
  369.  
  370.        Make sure that no range name in the macro is identical to one of
  371.        the range names in your worksheet. If this happens, change the
  372.        range name in your worksheet. In this version, we attached a
  373.        serial number to every macro range name, which insures there is
  374.        virtually no possibility of identical range names in the macros in
  375.        this package. Only the main (first) macro name in the macro is not
  376.        numbered because it has to be identical to the macro file name
  377.        which is limited by DOS to 8 characters only.
  378.  
  379.        All the macros have been designed to run under the macro managers
  380.        (except those listed in the LIST2.WK1 and LIST4.WK1 files) in
  381.        MANUAL and AUTOMATIC GLOBAL RECALCULATION modes. However, if you
  382.        find that a macro does not function properly, please check the
  383.        macro when the WORKSHEET GLOBAL RECALCULATION is in the AUTOMATIC
  384.        mode.
  385.  
  386.        2.1 MACRO FORMAT AND RULES TO ADD MACROS TO THE PACKAGE
  387.  
  388.        All macros are built this way:
  389.  
  390.        - The first nine cells in the first column are for use
  391.          instructions.
  392.        - The 10th cell holds the \Z macro name.
  393.        - The 11th cell holds the mnemonic macro name, which must be
  394.          IDENTICAL to the macro file name.
  395.        - Downward is for RANGE NAMES, etc.
  396.        - No blank cell is allowed in the first column. If the cell is
  397.          not used for a range name, then it must contain the exclamation
  398.          mark !. This also applies to the first nine cells. This way the
  399.          first column is always contiguous and we can use {END}{UP} or
  400.          {END}{DOWN} to assign or delete the range names.
  401.        - Add the macro name and description to the files list inside the
  402.          MACROMGR.WK1 file. Start with the DATABASE@xxx range name.
  403.        - Do not use the {QUIT} macro keyword because it stops the process
  404.          and exits to the READY mode, and the MANAGER's main menu will
  405.          not re-appear. Instead, use a branch instruction to an empty
  406.          routine like {BRANCH EMPTY} where EMPTY is an empty cell. There
  407.          is one exception to this: when an error routine is activated the
  408.          macro loses track. Instead of an empty cell, the cell should
  409.          contain the {BRANCH \Y} command.
  410.        - All the macros must start with the \Z macro name and {BREAKON}.
  411.  
  412.                                      - 8 -
  413.        EXAMPLE:
  414.  
  415.        The macro INVRTCOL.WK1 is shown here:
  416.  
  417.               A        B           C          D          E          F
  418.         1  *---A macro to invert a column of numbers or text
  419.         2  *---Use the / Range Name Label Right [End] [Down] [Return] to
  420.         3  *---define the range names in this column (starts with the \Z
  421.         4  *---macro name)
  422.         5  *---Hold the [Alt] key and press [Z] to activate the macro
  423.         6  !
  424.         7  !
  425.         8  !
  426.         9  !
  427.        10 \Z       {BREAKON}
  428.        11 INVRTCOL {WINDOWSOFF}{PANELOFF}/RNCInvert column ?~~/RNDInvert.
  429.        12 !        {WINDOWSOFF}{PANELOFF}{GOTO}Invert column ?~/WIC~/DF..
  430.        13 !        /DSRD{BS}.{END}{DOWN{RIGHT}~P~G~
  431.        14 !        /WDC~
  432.        15
  433.        16
  434.  
  435.        The A1 to A9 cells hold use instructions. The A10 cell contains
  436.        the \Z, and the A11 cell holds the INVRTCOL range name (identical
  437.        to the INVRTCOL[.WK1] file name). All the cells in the "A" column
  438.        which do contain a label name should contain the ! character. You
  439.        can build your own macros or adapt other macros to use with the
  440.        MACRO LIBRARY MANAGER as long as you follow these simple rules.
  441.  
  442.        3. THE MACRO LIBRARY MANAGERS
  443.  
  444.        3.1 GENERAL
  445.  
  446.        This package contains seven MACRO MANAGERS (in Disk_3): the
  447.        SMALLMGR.WK1 and the MACROMGR.WK1 files are for 2-D releases,
  448.        while the SMALLMG3.WK3 and the MACROMG3.WK3 files are for 3-D
  449.        releases. The SMALLMLB.WK1 and MACROMLB.WK1 and the NEW_MGR.MLB
  450.        files are for 2.2/2.3/2.4.
  451.  
  452.        The SMALLMGR.WK1 is about 6-7 KBYTE and is intended for use in
  453.        memory shortage situations. This macro manager displays the full
  454.        files directory list, and allows you to use POINT and SHOOT to
  455.        activate the macro you need. REMEMBER that this list will show all
  456.        the files in the directory unless your macros occupy a separate
  457.        sub-directory.
  458.  
  459.        The MACROMGR.WK1 file is almost 26 KBYTE. This manager has a
  460.        QUICK-RUN mode, like the SMALLMGR.WK1, as well as a full featured
  461.        SEARCH by KEYWORD working mode, which performs a QUERY on the
  462.        files list database to look for the matched MACRO DESCRIPTION.
  463.        Just enter the desired string and the manager will find all the
  464.        MACRO DESCRIPTIONS containing this string ANYWHERE in the
  465.        description. To move, use the {UP} and {DOWN} direction keys. To
  466.        activate the matched macro just press the [Return] key.
  467.  
  468.  
  469.                                      - 9 -
  470.  
  471.  
  472.        This special way of using the LOTUS query to activate a macro is
  473.        based on a discovery made by the developer of this package and was
  474.        published in the PC-MAGAZINE (SPREADSHEET CLINICS) July 1988, Vol.
  475.        13, page 414.
  476.  
  477.        The SMALLMLB.WK1 and the MACROMLB.WK1 are equivalent to the
  478.        previous two managers but activate the *.MLB macros instead of the
  479.        *.WK1 macros, and make use of the MACROMGR.ADN add-in supplied with
  480.        version 2.2. The SMALLMG3.WK3 and the MACROMG3.WK3 are equivalent
  481.        to the previous managers and activate the *.WK* macros using the
  482.        third dimension of the 3-D releases to keep the activated macro in
  483.        a separate sheet. The MEW_MNGR.MLB manager is a completely new type
  484.        of manager which resides in the memory (as do all *.MLB macros) and
  485.        activates the *.MLB macros using point and shoot.
  486.  
  487.        IMPORTANT:
  488.  
  489.        Unfortunately, the MACROMGR.ADN add-in, which comes with LOTUS
  490.        2.2/2.3/2.4 is limited, and does not allow the use of all the
  491.        commands that are allowed in the worksheet. Therefore, the number
  492.        of *.MLB macros is lower than the *.WK1 macros, and you still need
  493.        to use the macros that we could not make to work as *.MLB macros.
  494.        The LIST1.WK1 and the LIST2.WK1 files list the *.WK1 files and the
  495.        LIST3.WK1 and LIST4.WK1 files list the *.MLB files.
  496.  
  497.        3.2 USING THE MACRO LIBRARY MANAGERS (MACROMGR.WK1 & MACROMLB.WK1)
  498.  
  499.        The MACROMGR.WK1 activates the *.WK1 macros in the disk that can be
  500.        used with all versions of Lotus 1-2-3 from release 2 and up. The
  501.        MACROMG3.WK3 activates the *.WK* macros in the disk, and the
  502.        MACROMLB.WK1 activates the *.MLB macros in the disk that can only
  503.        be used with versions 2.2/2.3/2.4.
  504.  
  505.        We recommend that the you combine the MANAGER to an area outside
  506.        the work area (or a separate sheet in a 3-D release) to insure that
  507.        all the cells down to the manager are empty. It is best if the
  508.        macro manager code is below and left or below and right of the
  509.        working area, this assures that when you insert or delete rows,
  510.        it will not affect the macro manager. To get there quickly, use the
  511.        [End] [Home] [Right] [PgDn] keys or insert nine new columns left of
  512.        your data and use [End] [Home] [PgDn] [Left] to move the cell
  513.        pointer to the desired location of the macro. In both cases, if you
  514.        insert or delete rows in your data, the macro is not affected.
  515.  
  516.        Combine the MACRO LIBRARY MANAGER to an empty area (empty sheet in
  517.        a 3-D release) of your worksheet. Press / [F]ile [C]ombine [C]opy
  518.        [E]ntire-file, type MACROMGR or MACROMLB and press [Return]. Place
  519.        the cell pointer on the cell that contains the \Y macro name and
  520.        press: / [R]ange [N]ame [L]abel [R]ight [End] [Down] [Return] to
  521.        define all the range names. Press and hold the [MACRO] key ( [Alt]
  522.        for most computers [Ctrl] in 1-2-3 for Windows) and press [Y]. The
  523.        macro will start and the next menu will appear.
  524.  
  525.  
  526.                                      - 10 -
  527.  
  528.  
  529.        Default-dir  Search-by-keyword  Run_quick  View  List  Erase  Quit
  530.  
  531.        [D]efault-dir
  532.  
  533.        Choose this menu option to set the default directory to the same
  534.        directory where the macros are. If you try to run a macro which is
  535.        not in the default directory, it will result in an error message.
  536.  
  537.        [S]earch-by-Keyword
  538.  
  539.        Choose this menu option to look for the matched MACRO DESCRIPTION.
  540.        The macro will prompt you to insert the keyword to look for. Enter
  541.        the keyword (string) and press [Return] or just press [Return]. If
  542.        you press ONLY the [Return] key without a string, the manager will
  543.        look for the NULL string and allow you to use the [UP] and [Down]
  544.        keys to scroll through the description list.
  545.  
  546.        If you insert a string and press the [Return] key, the manager
  547.        starts a QUERY for all the matched descriptions, use the [UP] and
  548.        [Down] keys to page through the matched descriptions. When the
  549.        desired macro is highlighted, press the [Return] key to start it.
  550.        After a short delay the macro is operative. When the macro is
  551.        completed the manager deletes all the macro's range names and erases
  552.        the macro. Then the main menu re-appears.
  553.  
  554.        [R]un_quick
  555.  
  556.        A quick mode to start the macro, which is the same as in the
  557.        SMALLMGR.WK1. When you choose this menu option, the macro displays
  558.        the directory list. Highlight the macro to run and press [Return].
  559.        After a short delay the macro is operative. When the macro is
  560.        completed, the manager deletes all the macro's range names and
  561.        erases the macro. Then the main menu re-appears.
  562.  
  563.        NOTE: if the directory holds files other than the macros, all the
  564.              files are displayed. We recommend that you place the macros in
  565.              a separate directory.
  566.  
  567.        [V]iew
  568.  
  569.        Choose this menu option to display the directory list. Highlight
  570.        the macro to VIEW and press [Return]. After a short delay, the
  571.        macro code is displayed on the screen. Use ONLY the direction keys
  572.        to scroll through the macro. To execute the macro press [E]. If
  573.        you press the [Return] key, the manager erases the macro and the
  574.        main menu re-appears.
  575.  
  576.        [L]ist
  577.  
  578.        Choose this option to list all the files in the current directory.
  579.        This option allows you to verify the existence of a macro in the
  580.        current directory/disk. This is especially useful for 360K floppy
  581.        diskettes systems, because the macros are divided over many
  582.        diskettes. Press [Return] to quit the session.
  583.  
  584.  
  585.                                      - 11 -
  586.        [E]rase
  587.  
  588.        Choose this option to remove the MANAGER from the worksheet. All
  589.        the range names associated with the manager are deleted and the
  590.        manager text is erased from the worksheet, leaving no trace of the
  591.        manager. Because the manager erases itself, the process ends
  592.        with an ERROR. Therefore press [Return] to return to READY mode.
  593.  
  594.        NOTES:  a.  If you press [Ctrl Break] during the MANAGER SESSION,
  595.                    the error handling routine is activated and prompts
  596.                    you to press the [Return] key to return to the main
  597.                    menu. However, there is one problem: the manager will
  598.                    not be able to erase the macro's range names, and they
  599.                    will be added to the worksheet. To erase them, QUIT
  600.                    the manager and then place the cell pointer on an
  601.                    empty cell/area, activate the manager and activate the
  602.                    same macro again. When the macro is completed, the
  603.                    manager also erases the macro and all the range names.
  604.                b.  To use the [V]iew and [R]un_quick or [M]acro_run
  605.                    options in the main menus of ALL the managers, the
  606.                    *.WK1 files must also be included in the macros
  607.                    directory. Therefore, even if you use one of the
  608.                    2.2/2.3/2.4 versions and the *.MLB macros, keep the
  609.                    *.WK1 in the same directory.
  610.  
  611.        3.3 USING THE SMALL MACRO MANAGERS (SMALLMGR.WK1 & SMALLMLB.WK1)
  612.  
  613.        The SMALLMGR.WK1 can activate all the *.WK1 macros in the disk that
  614.        can be used with all versions of Lotus 1-2-3 from release 2 and up.
  615.        The SMALLMLB.WK1 can activate all the *.MLB macros in the disk that
  616.        can be used only with version 2.2/2.3/2.4. However, for these
  617.        managers to work, the equivalent *.WK1 macro MUST be included in the
  618.        same directory. The SMALLMLB uses the first range name (cell A11) in
  619.        the *.WK1 macro file to activate the *.MLB macros. The small manager
  620.        contains the same options as the full size manager except for the
  621.        "Search by Keyword" menu option. The [M]acro_run option is the same
  622.        as the [R]un_quick option in the MACROMLB.WK1 manager.
  623.  
  624.        NOTE: To use the [V]iew and [R]un_quick or [M]acro_run options in
  625.              the main menus of ALL the managers, the *.WK1 files must also
  626.              be included in the default directory. Even if you use one of
  627.              the 2.2/2.3/2.4 versions and the *.MLB macros, keep the *.WK1
  628.              in the same directory.
  629.  
  630.        3.4 USING THE NEW_MNGR.MLB
  631.  
  632.        Load the NEW_MNGR.MLB into memory the same way you load any *.MLB
  633.        macro. Make sure that no other *.MLB macros are loaded. (See the
  634.        README.TXT file for basic macro information and/or Lotus 1-2-3
  635.        documentation. Make sure that you define the Default directory to be
  636.        the same directory that holds the *.MLB macros. Press the ALT-F3
  637.        combination keys and point to the macro name. Press [Return] to
  638.        start the macro. The macro manager will load the macro that you
  639.        chose into memory and activate it. When you are finished with the
  640.        macro, the manager automatically removes it from the memory.
  641.  
  642.                                      - 12 -
  643.  
  644.  
  645.        This package includes an exiting utility, COMPILE.MLB, which
  646.        allows you to create your own managers like the NEW_MNGR.MLB. We
  647.        created the NEW_MNGR.MLB manager from the NEW_MNGR.PRN text
  648.        (ASCII) file using this (COMPILE.MLB) macro.
  649.  
  650.        3.4.1 USING THE COMPILE.MLB COMPILER TO CREATE NEW MANAGERS
  651.  
  652.        K.I.T.A.L. Software developed an *.MLB macro that can compile a
  653.        XXXXXXXX.PRN text file which contains a list of macro names from the
  654.        SUPER MACRO LIBRARY, into a macro manager with the same name, but
  655.        with the MLB extension ( XXXXXXXX.MLB ). When you use the compiled
  656.        MLB manager, the *.MLB macros in the default directory can be
  657.        activated using point and shoot. This package already contains the
  658.        NEW_MNGR.MLB manager which can activate over 200 macros, therefore
  659.        its size is 32K. If you have memory shortage problems you can create
  660.        smaller managers if you use partial lists of the NEW_MNGR.PRN text
  661.        file. Remember to give the new list a new name and make sure the
  662.        extension is ".PRN".
  663.  
  664.        1.  Attach the Lotus 2.2/2.3/2.4 MACROMGR.ADN using /AAMACROMGR
  665.            and press [Return].
  666.  
  667.        2.  Invoke the MACROMGR.ADN using /AIMACROMGR and press [Return].
  668.  
  669.        NOTE:  If the MACROMGR add-in is already in memory, remove all the
  670.               *.MLB macros from the memory or detach it using /ADMACROMGR
  671.               [Return] and start from step 1.
  672.  
  673.        3. Define the global default directory to the same directory where
  674.           you keep the macros of the SUPER MACRO LIBRARY.
  675.  
  676.        NOTE:  Erase the content of the worksheet using /FE... ; the
  677.               worksheet must be empty for the compiler to work correctly.
  678.  
  679.        4.  Load the COMPILE.MLB macro using /AIMACROMGR [Return] and choose
  680.            Load and highlight the COMPILE name and press [Return]. 5. Press
  681.            ALT-F3 and point to the @COMPILE name and press ENTER, then type
  682.            the name of the text file that holds the list of themacro names
  683.            and press [Return]. DO NOT type the PRN The macro creates a file
  684.            with the same name, but with the .MLB extension. This file is
  685.            the newborn manager.
  686.  
  687.        6.  Load the new file into memory and press ALT-F3, then point to
  688.            the macro to start and press [Return].
  689.  
  690.        SUMMARY:  Prepare a *.PRN ASCII file which contains the list of the
  691.                  *.MLB macros from the SUPER MACRO LIBRARY. The COMPILE.MLB
  692.                  macro builds a new MLB macro file using this list. The new
  693.                  file is a macro manager that can activate all the files in
  694.                  the list using point and shoot. You can create as many
  695.                  managers as you like using partial lists. The ASCII file
  696.                  must have the .PRN extension, but do not type the .PRN
  697.                  extension when the COMPILE macro asks for the name of the
  698.                  ASCII file.
  699.  
  700.  
  701.                                      - 13 -
  702.  
  703.  
  704.        4. THE MACRO WRITER (MACROHLP.WK1)
  705.  
  706.        This macro allows you to CONTINUOUSLY write every Lotus function
  707.        or macro command or ASCII/LICS character, including the extended
  708.        characters (above ASCII/LICS 128), using POINT and SHOOT to the
  709.        syntax on display. There are no more typing errors and need to
  710.        remember the exact syntax. This macro doesn't work with the
  711.        MANAGER and needs to be manually combined to the worksheet.
  712.  
  713.        4.1 USING THE MACRO WRITER (MACROHLP.WK1)
  714.  
  715.        Combine the MACROHLP.WK1 to the worksheet using /FCCEMACROHLP and
  716.        press [Return]. Use the /Range Name Label Right [End] [Down]
  717.        [Return] to define the range names in the first column (starting
  718.        with the \Z macro name). Place the cell pointer where you want to
  719.        start writing. Hold the [Alt] key and press [Z] to activate the
  720.        macro. The following list of all macro {COMMANDS} and @FUNCTIONS
  721.        "TYPES" will show up.
  722.  
  723.           "ABORT      "ADDRESS"   "ASCII      "CONTENTS"  "FORMAT"
  724.           "PREFIX"    "ROW"       "TYPE"      "WIDTH"     @ABS
  725.           @ACOS       @ASIN       @ATAN       @ATAN2      @CELL
  726.           @CELLPOINTER@CHAR       @CHOOSE     @CODE       @COLS
  727.           @COS        @COUNT      @DATE       @DAVG       @DAY
  728.           @DCOUNT     @DDB        @DMAX       @DMIN       @DSTD
  729.           @DSUM       @DTVALUE    @DVAR       @ERR        @EXACT
  730.           @EXP        @FALSE      @FIND       @FV         @HLOOKUP
  731.           @HOUR       @IF         @INDEX      @INT        @IRR
  732.           @ISERR      @ISNA       @ISNUMBER   @ISSTRING   @LEFT
  733.           @LENGTH     @LN         @LOG        @LOWER      @MAX
  734.           @MID        @MIN        @MINUTE     @MOD        @MONTH
  735.           @N          @NA         @NOW        @NPV        @PI
  736.           @PMT        @PROPER     @PV         @RAND       @RATE
  737.           @REPEAT     @REPLACE    @RIGHT      @ROUND      @ROWS
  738.           @S          @SECOND     @SIN        @SLN        @SQRT
  739.           @STD        @STRING     @SUM        @SYD        @TAN
  740.           @TERM       @TIME       @TIMEVALUE  @TRIM       @TRUE
  741.           @UPPER      @VALUE      @VAR        @VLOOKUP    @YEAR
  742.           {BREAKOFF}  {BREAKON}   {CALC}      {CONTENTS}  {DEFINE}
  743.           {DISPATCH}  {DOWN}      {EDIT}      {END}       {ESC}
  744.           {FILESIZE}  {FORBREAK}  {FOR}       {GETLABEL}  {GETNUMBER}
  745.           {GETPOS}    {GET}       {GOTO}      {GRAPH}     {HOME}
  746.           {IF}        {INDICATE}  {LEFT}      {LET}       {LOOK}
  747.           {MENUBRANCH}{MENUCALL}  {NAME}      {ONERROR}   {OPEN}
  748.           {PANELOFF}  {PANELON}   {PGDN}      {PGUP}      {PUT}
  749.           {QUERY}     {QUIT}      {READLN}    {READ}      {RECALCOL}
  750.           {RECALC}    {RESTART}   {RIGHT}     {UP}        {WAIT}
  751.           {WINDOWSOFF}{WINDOWSON} {WINDOW}    {WRITELN}   {WRITE}
  752.  
  753.        Move to one of them and press [Return]. The macro writes the text
  754.        to the anel and waits for you to edit and press [Return]. Press
  755.        [Return] to accept. When the list shows up again, choose again and
  756.        press [Return]. The macro adds the new text to the previous one
  757.        and displays the result in the panel. You can continuously write
  758.        MACROS, FUNCTIONs, etc.
  759.  
  760.                                      - 14 -
  761.  
  762.  
  763.        For example, let's write the @SIN(0.5)+@COS(0.5)+@TAN(0.5) formula
  764.        to the K1..K1 cell.
  765.        - Place the cell pointer on the K1..K1 cell.
  766.        - Activate the macro using ALT + Z.
  767.        - Move to the @SIN in the display and press [Return]. The panel
  768.          will show: '@SIN(X) with the cursor on the X. Replace the X with
  769.          0.5 and add + to get '@SIN(0.5)+ and press [Return]. The full
  770.          list appears again.
  771.        - Move to the @COS in the display and press [Return]. The panel
  772.          will show:  '@SIN(0.5)+@COS(X) with the cursor on the X. replace
  773.          the X with 0.5 and add + to get '@SIN(0.5)+@COS(0.5)+ and
  774.          press [Return].
  775.        - Repeat with the @TAN, but don't add the + and press [Return].
  776.          The full list appears again.
  777.        - Choose "ABORT (probably the first) and press [Return].
  778.  
  779.        The result, of 1.903310, will show up in cell K1. If you have
  780.        followed this procedure, you have noticed that the macro took care
  781.        of the apostrophe ' at the beginning of the formula. In he same
  782.        way, you can build macros using the building blocks in the screen
  783.        display. However, remember that LOTUS accepts 240 characters (512
  784.        in the 3-D releases) maximum in a line and formulas must be legal.
  785.  
  786.        Use this macro to incorporate all the ASCII/LICS characters set in
  787.        your text. Choose the "ASCII option from the display, the full
  788.        character set table appears. Move to the character to print and
  789.        press [Return]. The macro adds the character to the text in the
  790.        panel. REMEMBER that the content of the table depends on the LOTUS
  791.        installation, and if you use the ANSI.SYS driver or not. For
  792.        more information, see your DOS and LOTUS manuals.
  793.  
  794.        5. THE LINK MACRO (LINK.WK1)
  795.  
  796.        This macro links cells in the current worksheet to cells/ranges in
  797.        other external worksheets on disk. Combine this macro to any
  798.        worksheet that needs to be linked. Combine it to an empty area of
  799.        your worksheet and make sure that there will be enough empty rows
  800.        to accommodate the linking information table.
  801.  
  802.        5.1 USING THE LINK MACRO (LINK.WK1)
  803.  
  804.        The LINK.WK1 file is already linked to the TEST1.WK1 file. Set the
  805.        default directory to the directory occupied by the macros and
  806.        Retrieve the LINK.WK1. Notice how the file collects the
  807.        information from the TEST1.WK1 file during the RETRIEVE process.
  808.        The link information table appears for few seconds:
  809.  
  810.        -----------------------------------------------------------------
  811.        EXTERNAL-FILE EXTERNAL-RANGE LINKED-CELL-NAME LINKED-CELL-ADDRESS
  812.        -----------------------------------------------------------------
  813.        TEST1          B2              LINK1             $A$71
  814.        TEST1          A1              LINK2             $A$72
  815.        TEST1          C1              LINK3             $A$73
  816.        TEST1          C2              LINK4             $A$74
  817.        TEST1          D1              LINK5             $A$95
  818.  
  819.                                      - 15 -
  820.  
  821.  
  822.        Then the cell pointer is placed on A1..A1. When you COMBINE the
  823.        LINK.WK1 file to your worksheet, ERASE the contents of the table.
  824.        Otherwise, when the LINK macro is activated, an error message will
  825.        appear because all range names are stripped when a worksheet is
  826.        combined.
  827.  
  828.        5.2 FILE LINKING INFORMATION TABLE
  829.  
  830.        The table holds information concerning the linked cells (for
  831.        example LINK1 at $A$71) and the external file TEST1.WK1 (cell
  832.        B2..B2). The \0 macro uses the TABLE to update the linked cell
  833.        from the data in the external file TEST1.WK1.
  834.  
  835.        5.3 ESTABLISHING OR EDITING A LINK
  836.  
  837.        Place the cell pointer on the cell to be linked. Use the [Alt] key
  838.        and press [Y] to ESTABLISH linking between the cell and
  839.        cells/ranges in the other worksheet. The panel displays:
  840.  
  841.        " Point to the CELL to be linked and press [Return] or press [Esc]
  842.          to Quit "
  843.  
  844.        Now you can move to another location and press [Return] or just
  845.        press return to continue. The link table appears and the next
  846.        prompt is displayed in the panel:
  847.  
  848.        " Move up to edit and press [Return] or just press [Return] "
  849.  
  850.        ---------------------------------------------------------------
  851.        EXTERNAL-FILE EXTERNAL-RANGE LINKED-CELL-NAME LINKED-CELL-ADDRS
  852.        ---------------------------------------------------------------
  853.        TEST1          B2              LINK1             $A$71
  854.        TEST1          A1              LINK2             $A$72
  855.        TEST1          C1              LINK3             $A$73
  856.        TEST1          C2              LINK4             $A$74
  857.        TEST1          D1              LINK5             $A$95
  858.  
  859.        The cell pointer is located at the table. If you want to edit a
  860.        link, use the direction keys to move upward and press [Return]. If
  861.        you want to add linked cells, press [Return]. The next prompt is:
  862.  
  863.        " WHICH FILE TO LINK: "
  864.  
  865.        Enter the external file name and press [Return]. The cell pointer
  866.        moves one cell to the right and the next prompt appears:
  867.  
  868.        " INSERT RANGE NAME OR RANGE ADDRESS TO LINK TO THIS CELL: "
  869.  
  870.        Enter the external cell/range name or address and press [Return].
  871.        The cell pointer moves one cell to the right and the next prompt
  872.        appears:
  873.  
  874.  
  875.  
  876.                                      - 16 -
  877.  
  878.  
  879.        " ASSIGN A RANGE NAME TO THIS CELL: "
  880.  
  881.        Enter a name to be assigned to the linked cell in the current
  882.        worksheet and press [Return]. The cell pointer moves one cell to
  883.        the right and also inserts the cell address. The first prompt
  884.        appears again:
  885.  
  886.        " Point to the CELL to be linked and press [Return] or press
  887.          [Esc] to Quit "
  888.  
  889.        Repeat this procedure again to link more cells or press [Esc]. To
  890.        update the worksheet, hold the [Alt] key and press [Z].
  891.  
  892.        After te worksheet containing this macro is saved, the next time
  893.        it is retrieved the AUTO macro \0 will UPDATE all the linked cells
  894.        automatically.
  895.  
  896.        6. THE WORD PROCESSOR MACRO (WORDPROC.WK1)
  897.  
  898.        A WORD PROCESSOR macro with a full featured SEARCH & REPLACE and
  899.        an adjustable line width.
  900.  
  901.        6.1 USING THE WORD PROCESSOR MACRO (WORDPROC.WK1)
  902.  
  903.        Combine the WORDPROC.WK1 file to the worksheet and use /Range Name
  904.        Label Right [End] [Down] [Return] to define the range names in the
  905.        first column (starting with the \Z macro name). Hold the [Alt] key
  906.        and press [Z] to activate the macro, the following prompt appears:
  907.  
  908.        " Number of characters in line ? "
  909.  
  910.        Enter the line width and press [Return], the macro will adjust the
  911.        column width and the following menu will appear:
  912.  
  913.        Typing  Re-justify  Search & Replace  Quit
  914.  
  915.        [T]yping
  916.  
  917.        When you choose this option, the macro waits for you to begin to
  918.        type. Press the [Return] key and the macro justifies the whole
  919.        paragraph and moves to the bottom of the paragraph and waits for
  920.        you to continue typing. Be careful to separate paragraphs by an
  921.        EMPTY cell\line, otherwise when you press [Return], the whole
  922.        document will be justified as a single paragraph.
  923.  
  924.        Press [Esc] to return to the main menu.
  925.  
  926.        [R]e-justify
  927.  
  928.        Use this option to change the line width. When you choose this
  929.        option, the following prompt appears:
  930.  
  931.        " Number of characters in line ? "
  932.  
  933.  
  934.                                      - 17 -
  935.  
  936.  
  937.        Insert the new line width and press [Return]. The macro will
  938.        justify the whole paragraph to the new line width.
  939.  
  940.        [S]earch & Replace
  941.  
  942.        This option gives you the same features as the file SCRHREPL.WK1.
  943.        See Chapter 7.
  944.  
  945.        7. THE SEARCH & REPLACE MACRO (SCRHREPL.WK1)
  946.  
  947.        A macro to SEARCH and REPLACE labels or values in a range. The
  948.        macro features:
  949.  
  950.        - Exact match (case sensitive)
  951.          a. Replace All
  952.          b. Find and Replace, Skip or Quit
  953.  
  954.        - Inexact match (case insensitive)
  955.          a. Replace All
  956.          b. Find and Replace, Skip or Quit
  957.  
  958.        7.1 USING THE SEARCH & REPLACE MACRO (SCRHREPL.WK1)
  959.  
  960.        Combine the SCRHREPL.WK1 file to the worksheet and use /Range Name
  961.        Label Right [End] [Down] [Return] to define the range names in the
  962.        first column (starting with the \Z macro name).
  963.  
  964.        Place the cell pointer at the upper left cell (A10..A10 for
  965.        example) of the range to be searched. Hold the [Alt] key and press
  966.        [Z] to activate the macro, the following prompt appears:
  967.  
  968.                Which range ?               Enter range: A10
  969.  
  970.        Press the PERIOD . to anchor the cell and "paint" the range to
  971.        be searched. Press [Return] and follow the on screen/panel prompts
  972.        and instructions.
  973.  
  974.        8. THE RUN KEY MACRO (RUNKEY2.WK1)
  975.  
  976.        A macro that ACTIVATES any macro/routine without the use of the
  977.        Alt] key. When you start this macro, all the range names in your
  978.        worksheet are displayed on screen. POINT to the macro/routine
  979.        name and press [Return] to start the macro/routine.
  980.  
  981.        8.1 USING THE RUN KEY MACRO (RUNKEY2.WK1)
  982.  
  983.        Use /Range Name Label Right [End] [Down] [Return] to define the
  984.        range names in the first column (starting with the \Z macro name).
  985.        Hold the [Alt] key and press [Z] to activate the macro. A full
  986.        screen list of all the range names/routines in your worksheet will
  987.        show up. Point to the routine name and press [Return]. The routine
  988.        will be activated. This macro eliminates using the ALT+key
  989.        combination to activate a macro and overcome the limitation of
  990.        maximum 26 characters in the English alphabet.
  991.  
  992.  
  993.                                      - 18 -
  994.  
  995.  
  996.        9. THE MENU RANGE MACRO (MENURANG.WK1)
  997.  
  998.        This macro gives you the ability to define/turn any rectangular
  999.        range of cells into an active MENU RANGE. Every item in a cell is
  1000.        a menu title (routine name). When you place the cell pointer on
  1001.        one of the titles, the description line appears in the panel
  1002.        exactly as in the 1-2-3 menu bar. When you press the [Return] key
  1003.        the routine is activated. This macro is mainly for application
  1004.        developers to avoid nested menus.
  1005.  
  1006.        9.1 USING THE MENU RANGE MACRO (MENURANG.WK1)
  1007.  
  1008.        Use /Range Name Label Right [End] [Down] [Return] to define the
  1009.        range names in the first column (starting with the \Y macro name).
  1010.        Hold the [Alt] key and press [Y] to define the MENU RANGE,
  1011.        highlight the MENU RANGE and press [Return]. The MENU RANGE needs
  1012.        to be defined ONLY once.
  1013.  
  1014.        The menu range can look like this:
  1015.  
  1016.               Routine1    routine2     routine3
  1017.               Routine4    routine5     routine6
  1018.               Routine7    routine8     routine9
  1019.               Routine10   routine11    routine12
  1020.               Routine13   routine14    routine15
  1021.  
  1022.        For every routine name in the MENU RANGE, there should be a
  1023.        routine with the same name in the worksheet.
  1024.  
  1025.        A routine should always start with the description line
  1026.        immediately followed by the macro name "{exec283}" as follows:
  1027.  
  1028.        routine1   This is the description line: {exec283}
  1029.                   {GOTO}EMPTYAREA~/FCCE{?}~
  1030.                   {BRANCH MENURANG}
  1031.  
  1032.        This is an example of a COMBINING routine. The first line is
  1033.        composed of the description line "This is the description line: "
  1034.        and the macro routine {exec283}. The {exec283} routine executes
  1035.        your keyboard entries (direction keys only) and executes the main
  1036.        routine when you press the RETURN key. The last line can hold the
  1037.        {BRANCH MENURANG} to insure that the menu range will be activated
  1038.        when the routine is finished.
  1039.  
  1040.        Hold the [Alt] key and press [Z] to USE the MENU-RANGE, or use
  1041.        {BRANCH MENURANG} inside or from another macro. Use the direction
  1042.        keys to move between the menu items (notice the description line
  1043.        in the panel) press RETURN to activate the routine.
  1044.  
  1045.        10. THE MACRO RECORDER (RECORDER.WK1)
  1046.  
  1047.        A macro to RECORD and EXECUTE keystrokes as they are typed. The
  1048.        macro allows you to use LOTUS 1-2-3 and simultaneously records
  1049.        your keystrokes in the background into a macro that can be used
  1050.        again.
  1051.  
  1052.                                      - 19 -
  1053.  
  1054.  
  1055.        10.1 USING THE MACRO RECORDER (RECORDER.WK1)
  1056.  
  1057.        Use /Range Name Label Right [End] [Down] [Return] to define the
  1058.        range names in the first column (starting with the \Z macro name).
  1059.        Hold the [Alt] key and press [Z] to activate the macro. Your
  1060.        keystrokes will be recorded and placed out of the working area.
  1061.        Use Ctrl-Break to Quit. To locate the recorded keystrokes, press
  1062.        [End] [Home] [Right] [End] [Up] [Left].
  1063.  
  1064.        11. RANGE PROCESSING MACROS
  1065.  
  1066.        This package contains a large number of macros to process ranges.
  1067.        Unless otherwise specified, place the cell pointer at the upper
  1068.        left cell of the range to be processed and activate the macro. A
  1069.        prompt like the following usually appears:
  1070.  
  1071.           Which range ?                    Enter range A1
  1072.  
  1073.        Move and "paint" the range using the arrow keys. However to
  1074.        "paint" the range you need to ANCHOR the cell pointer, therefore
  1075.        press the PERIOD . key and the prompt should look like:
  1076.  
  1077.           Which range ?                    Enter range A1..A1
  1078.  
  1079.        Now use the arrow keys to expand and highlight ("paint") the range
  1080.        and press [Return].
  1081.  
  1082.        11.1 THE POWERFUL PERIOD .
  1083.  
  1084.        This tiny PERIOD . is one of the most effective and powerful keys
  1085.        in LOTUS 1-2-3. It ANCHORs and FREEs the cell pointer and allows
  1086.        you to visit all corners of the highlighted range just by
  1087.        repeatedly pressing the PERIOD . key, so you can expand a range
  1088.        into all directions simultaneously. When you will press the PERIOD
  1089.        . you will notice that each time the . is pressed, the cursor
  1090.        jumps to the next corner of the highlighted range.
  1091.  
  1092.        12. DATABASE MACROS
  1093.  
  1094.        When you are using the database macros, ALWAYS make sure that the
  1095.        database range and the output range have at least two empty rows
  1096.        above to accommodate for the criterion range.
  1097.  
  1098.        13. ADD-IN MACROMGR.ADN MACRO UTILITIES
  1099.  
  1100.        In this package, we have included a few macros (LIBMAKE*.WK1) to
  1101.        help you work with the MACROMGR.ADN add-in, supplied with Lotus
  1102.        1-2-3 version 2.2/2.3 or 2.4. This manager can save *.WK1 files as
  1103.        *.MLB files. The MACROMGR.ADN add-in loads the *.MLB macros into
  1104.        the memory instead of the worksheet. As explained in the Lotus
  1105.        manual, to activate an *.MLB macro the MACROMGR.ADN you first must
  1106.        attach it to the worksheet using the / Add-in Attach ... sequence.
  1107.        Then you have to INVOKE it using / Add-in Invoke ... sequence, or
  1108.        the ALT-F* assigned function key. Then choose the [L]oad menu
  1109.        option to load the *.MLB macros.
  1110.  
  1111.                                      - 20 -
  1112.  
  1113.  
  1114.        To activate the macro, press ALT-F3 and point to the macro/routine
  1115.        name that you want to start and press [Return]. When you press
  1116.        ALT-F3, all the range/routine names in the worksheet file and the
  1117.        macro are displayed on screen. This makes it difficult to locate
  1118.        the macro/routine name to activate. To make it easy to locate the
  1119.        main routines, the LIBMAKE.WK1 macro adds the ASCII character no.
  1120.        2 [@CHAR(2)] to the main routine name of the macro. This character
  1121.        appears on the panel as - preceding the main routine name. For
  1122.        example if the macro name is "CENTER" the main routine name will
  1123.        be "-CENTER" this makes it much easier to locate it on a screen
  1124.        filled with range names.
  1125.  
  1126.        NOTE:  Due to a serious bug in the new Lotus 2.4, the "-CENTER"
  1127.               name does not appear at all; however Lotus recognize it
  1128.               when it is called from a macro. Lotus 2.4 users should
  1129.               look for the "CENTER" name to start the macro. Because of
  1130.               this nasty bug, we had to update more than 200 *.MLB macro.
  1131.  
  1132.        The MACROMLB.WK1 and SMALLMLB.WK1 macro managers templates look
  1133.        for the @CHAR(2) character. Therefore, if you create macros and
  1134.        save them as *.MLB library macros without using the LIBMAKE.WK1
  1135.        macro, you have to add the @CHAR(2) character to the macro's main
  1136.        routine. For example: if the macro's main routine name is CENTER'
  1137.        press the F2 key to switch to EDIT mode and delete the ', then
  1138.        enter @CHAR(2)&"CENTER". Now press CALC (the F9 key). The result
  1139.        is [ CENTER]. The space before the CENTER is the @CHAR(2), which
  1140.        appears as -CENTER on screen when you press ALT-F3.
  1141.  
  1142.        NOTE: The @CHAR(2)&"CENTER" formula should appear exactly as you
  1143.              see it, including the double quotes"". The CALC or F9 key
  1144.              turns the formula into a label. You can also use /Range
  1145.              Value ...
  1146.  
  1147.        13.1 LIBRARY MAKE MACROS (LIBMAKE.WK1, LIBMAKE2.WK1& LIBMAKE3.WK3)
  1148.  
  1149.        LIBMAKE.WK1 and LIBMAKE2.WK1 were designed for 2.2/2.3/2.4. The
  1150.        LIBMAKE.WK1 macro is especially built to be used with *.WK1 macros
  1151.        that follow the simple rules in paragraph 2.1 of this document.
  1152.        This macro allows you to easily create separate library macros
  1153.        from the *.WK1 macros. We have used this macro to create all the
  1154.        *.MLB macros in this package. For macros that don't follow these
  1155.        rules, use the LIBMAKE2.WK1 macro, but remember that you will not
  1156.        be able to enjoy the following benefits.
  1157.  
  1158.        You can create macros, one at a time by point and shoot to a macro
  1159.        name in the screen display, or let the macro create *.MLB library
  1160.        macros from all the *.WK1 macros in the default directory in one
  1161.        step. You can combine any number of *.WK1 files to one *.MLB
  1162.        library or combine any number of the *.MLB library macros in this
  1163.        package into one *.MLB library macro.
  1164.  
  1165.        IMPORTANT: Before you use the LIBMAKE.WK1, make sure that there
  1166.                   are no *.MLB macros in the directory by the same names
  1167.                   as the macros you plan to create. Remove all the *.MLB
  1168.                   macros from the memory using the LIBRMOVE.WK1 macro or
  1169.                   the /Add-in Invoke ... sequence.
  1170.  
  1171.                                      - 21 -
  1172.  
  1173.  
  1174.        The LIBMAKE3.WK3 is for 3-D releases of Lotus 1-2-3. It allows you
  1175.        to create macro libraries by combining separate macros into one
  1176.        file. You can combine the macros into one sheet, one after another
  1177.        or stacked together in a multiple sheet file. A multiple sheet
  1178.        library is preferred because it allows you to delete a macro from
  1179.        the library if you delete the sheet. Before you combine a multiple
  1180.        sheet library into your worksheet, make sure to add enough empty
  1181.        sheets to accommodate the library. Use the / Worksheet Insert
  1182.        Sheet ... sequence. When you create a library, the LIBMAKE3.WK3
  1183.        macro adds an opening sheet to the macro sheets, which states the
  1184.        number of macros in the sheet and instructions for how to use the
  1185.        new library.
  1186.  
  1187.        14. ALL OTHER MACROS
  1188.  
  1189.        Unless otherwise specified, place the cell pointer at the upper
  1190.        left cell of the range to be processed and start the macro
  1191.        manually or use one the appropriate MANAGERs.
  1192.  
  1193.        15. SYSTEM REQUIREMENTS
  1194.  
  1195.        IBM(R) PC, XT, AT, PS2 or compatibles, DOS 2.0 or higher
  1196.        LOTUS 1-2-3 Version 2.0/2.01 and up or 100% compatible
  1197.        spreadsheets.
  1198.  
  1199.        (C)Copyright K.I.T.A.L. Software, 1989-1992. All rights reserved.
  1200.  
  1201.        Please send your comments about the software to K.I.T.A.L.
  1202.        Software.
  1203.  
  1204.        LHA is a registered trademark of (C)Yoshi 1988-1991. All rights
  1205.        reserved.
  1206.        Lotus and 1-2-3 are registered trademarks of Lotus Development
  1207.        Corporation.
  1208.        IBM is a registered trademark of International Business Machines
  1209.        Corporation.
  1210.