home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: WPS_PM / WPS_PM.zip / PMASST.ZIP / PMASST.TXT < prev    next >
Text File  |  1991-05-07  |  152KB  |  2,580 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.                                     PM Assistant
  32.  
  33.                                     User's Guide
  34.  
  35.                                      Version 1.0
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.                                            Advanced
  59.                                            Tools
  60.                                     Utilis                                    Utilis                                    Utilis Now
  61.  
  62.  
  63.           ii   PM Assistant User's Guide
  64.  
  65.  
  66.           Utilis License Agreement
  67.  
  68.           Any use whatsoever of the software provided indicates your
  69.           acceptance of the following license agreement between you (the
  70.           user) and Utilis Inc.
  71.  
  72.           1. Utilis grants you (the single user) the right to use the
  73.              provided software on a single computer.  The software may not
  74.              be simultaneously accessible to any other users or any other
  75.              computers (i.e., can not be used from a network).
  76.  
  77.           2. Utilis grants you the right to copy the software to your hard
  78.              disk and you may make a single backup copy of the software.
  79.              These copies may not be used on any other computers.
  80.  
  81.           3. Utilis grants you the right to distribute up to twenty (20)
  82.              copies of the pmademo.exe demonstration utility and
  83.              pmasst.dll dynamic link library for the sole purpose of
  84.              running demonstrations you create with PM Assistant.  Contact
  85.              Utilis for information regarding licenses to distribute more
  86.              than twenty copies of pmademo.exe.
  87.  
  88.           4. No materials provided in this package (software or manuals)
  89.              may be copied, loaned, rented, or otherwise distributed by
  90.              any means except as specified in items (2) and (3).
  91.  
  92.           5. You may not decompile, disassemble, reverse engineer, or
  93.              otherwise observe the internal workings of the provided
  94.              software.
  95.  
  96.           Satisfaction Guarantee
  97.           The provided materials are guaranteed to work to your
  98.           satisfaction.  If you are not satisfied, return the program and
  99.           documentation to Utilis, along with proof of purchase, no later
  100.           than 90 days after purchase for a full refund.
  101.  
  102.  
  103.           No Other Warranties
  104.           Utilis disclaims all other warranties, either express or implied,
  105.           including but not limited to implied warranties of
  106.           merchantability and fitness for a particular purpose, with
  107.           respect to any of the provided materials.
  108.  
  109.           In no event shall Utilis, its suppliers, distributors or
  110.           employees, be liable for any damage whatsoever (including but not
  111.           limited to damages for loss of business profits, loss of data or
  112.           software, damage to hardware, or other pecuniary loss) arising
  113.           out of the use of or inability to use this Utilis product.
  114.  
  115.           State laws vary regarding the limitation of warranties and
  116.           liability, so not all these restrictions may apply to you.
  117.  
  118.           Copyright c 1991, Utilis Inc.  All Rights Reserved.
  119.           Utilis Inc., P.O. Box 15905, Seattle, Washington  98115
  120.  
  121.  
  122.                                              PM Assistant User's Guide  iii
  123.  
  124.  
  125.           PM Assistant and Advanced Tools Now are trademarks of Utilis Inc.
  126.           OS/2 is a trademark of International Business Machines
  127.           Corporation.
  128.  
  129.  
  130.           iv   PM Assistant User's Guide
  131.  
  132.  
  133.  
  134.  
  135.                                       Contents
  136.  
  137.  
  138.           1          1          1 Introduction            Introduction            Introduction ................................                         ................................                         .................................................                                                         .................                                                         .................1                                                                          1                                                                          1
  139.             Installing PM Assistant ......................................1
  140.             Starting And Exiting PM Assistant ............................2
  141.             The PM Assistant Display .....................................3
  142.             The Status/Help Line .........................................3
  143.             On-line Help .................................................4
  144.             Keyboard Interface ...........................................5
  145.             Mouse Interface ..............................................5
  146.             Document Notes ...............................................5
  147.             Terms ........................................................6
  148.  
  149.           2          2          2 Macros            Macros            Macros ................................                   ................................                   .......................................................                                                   .......................                                                   .......................9                                                                          9                                                                          9
  150.             Creating Macros ..............................................9
  151.             Changing Macro Settings .....................................10
  152.             Executing Macros ............................................10
  153.             Start Program Macro .........................................11
  154.             Position Window Macro .......................................13
  155.             Mouse & Keyboard Input Macro ................................15
  156.             Keyboard Input Macro ........................................19
  157.             Group and Compound Macros ...................................20
  158.             Customize Menu Macro ........................................21
  159.             Building Sets of Macros .....................................24
  160.             Macro Execute Command .......................................26
  161.             Disabling Macros ............................................26
  162.             Macro Options ...............................................27
  163.           3          3          3 Editing Macro Listings            Editing Macro Listings            Editing Macro Listings ................................                                   ................................                                   ......................................                                                                   ......                                                                   ......29                                                                         29                                                                         29
  164.             Moving Macros ...............................................29
  165.             Copying Macros ..............................................30
  166.             Deleting Macros .............................................30
  167.  
  168.           4          4          4 Viewing Macros            Viewing Macros            Viewing Macros ................................                           ................................                           ..............................................                                                           ..............                                                           ..............31                                                                         31                                                                         31
  169.             Expanding and Collapsing Macros .............................31
  170.             Finding Macros ..............................................32
  171.             Suppressing the Status/Help Line ............................33
  172.             Viewing Memory Statistics ...................................33
  173.  
  174.           5          5          5 Macro Files            Macro Files            Macro Files ................................                        ................................                        .................................................                                                        .................                                                        .................35                                                                         35                                                                         35
  175.             Opening Macro Files .........................................35
  176.             Merging Macro Files .........................................36
  177.             Saving Macro Files ..........................................36
  178.             New Macro Files .............................................36
  179.             Printing Macro Lists ........................................37
  180.  
  181.           6          6          6 Control Features            Control Features            Control Features ................................                             ................................                             ............................................                                                             ............                                                             ............39                                                                         39                                                                         39
  182.             Process Priorities ..........................................39
  183.             Password Protection .........................................41
  184.             Screen Saver ................................................42
  185.             Invoking Password Protection, Screen Saver, or Both .........43
  186.             Speed Button ................................................44
  187.  
  188.  
  189.                                              PM Assistant User's Guide    v
  190.  
  191.  
  192.           7          7          7 Demonstration Utility            Demonstration Utility            Demonstration Utility ................................                                  ................................                                  .......................................                                                                  .......                                                                  .......45                                                                         45                                                                         45
  193.             Demo Files ..................................................45
  194.             Control Directives ..........................................46
  195.             Text Formatting Directives ..................................47
  196.  
  197.           Index          Index          Index................................               ................................               ..........................................................                                               ..........................                                               ..........................49                                                                         49                                                                         49
  198.  
  199.  
  200.                                               Chapter 1:  Introduction    1
  201.  
  202.  
  203.  
  204.  
  205.           1          1          1    Introduction               Introduction               Introduction
  206.  
  207.  
  208.           Welcome to Utilis Presentation Manager Assistant.  PM Assistant
  209.           is designed to make working with Presentation Manager more con-
  210.           venient and more efficient.
  211.  
  212.           Using PM Assistant, you can:
  213.  
  214.            -           -           -Automate repetitive tasks using macros.
  215.            -           -           -Start, position, and initialize your PM applications
  216.             automatically.
  217.            -           -           -Switch to Presentation Manager applications and full-screen
  218.             sessions with a single keystroke.
  219.            -           -           -Customize the menus of your favorite applications.
  220.            -           -           -Set, view, and change the process priorities of programs
  221.             under OS/2.
  222.            -           -           -Protect your screen with the Screen Saver feature.
  223.            -           -           -Prevent unauthorized access to your machine with Password
  224.             Protection.
  225.            -           -           -Speed up dialog box interaction with Speed Button.
  226.            -           -           -Create automated demonstrations of your programs and
  227.             procedures.
  228.  
  229.  
  230.           Installing PM Assistant          Installing PM Assistant          Installing PM Assistant
  231.  
  232.           To install PM Assistant:
  233.  
  234.           1. Insert the PM Assistant disk into drive A:
  235.  
  236.           2. Type a:install at the OS/2 command prompt.
  237.  
  238.           3. The installation program will prompt you through the
  239.              installation process.
  240.  
  241.           NOTE:
  242.           The files on the distribution disk are not compressed and can be
  243.           copied using the OS/2 copy command.  The Dynamic Link Library
  244.           file pmasst.dll must be placed in a directory specified on the
  245.           LIBPATH line of your config.sys file (the installation program
  246.           will do this for you).
  247.  
  248.  
  249.           Starting And Exiting PM Assistant          Starting And Exiting PM Assistant          Starting And Exiting PM Assistant
  250.  
  251.           You can start PM Assistant in three ways:  through the Start
  252.           Programs application, through the File System application, or at
  253.           the OS/2 prompt.  You can run only one instance of PM Assistant
  254.           at a time.
  255.  
  256.  
  257.           2    PM Assistant User's Guide
  258.  
  259.  
  260.           To start PM Assistant through the Start Programs application:
  261.  
  262.           >          >          >  Double-click the PM Assistant line in the Start Programs
  263.              window.
  264.                The PM Assistant installation program will add PM
  265.                Assistant to the Start Programs Main Group if
  266.                requested.
  267.  
  268.           To start PM Assistant through the File System:
  269.  
  270.           >          >          >  Double-click the `                               `                                pmasst.exe'                                           '                                             file.
  271.  
  272.           To start PM Assistant at the OS/2 prompt:
  273.  
  274.           >          >          >  Type pmasst [filename] [/e macroname] [/q] at the OS/2
  275.              prompt.
  276.  
  277.              The command line arguments are optional:
  278.              filename -                        The name of a macro file.  PM Assistant loads
  279.                the specified file on startup.
  280.  
  281.              /e macroname -                            A macro to execute.  PM Assistant executes
  282.                the named macro on startup.  You can have any number of
  283.                /e arguments on the command line; they will be executed
  284.                in order from left to right.  When using this argument,
  285.                you must also specify with the filename argument a
  286.                macro file which contains the named macro.
  287.              /q                  - Quit.  PM Assistant quits after any macros have been
  288.                executed using the /e argument.
  289.  
  290.  
  291.           To Exit PM Assistant:
  292.  
  293.           >          >          >  Choose File Exit                    File Exit                    File Exit.
  294.  
  295.  
  296.           The PM Assistant Display          The PM Assistant Display          The PM Assistant Display
  297.  
  298.                       ----------------------------------------
  299.                       |              PM Assistant             |
  300.                       |---------------------------------------|
  301.                       |F9    PW     Macroname    Macro comment|
  302.                       | ^     ^Macro Type                     |
  303.                       | ^Hot-key                              |
  304.                       |                                       |
  305.                       |                                       |
  306.                       |_______________________________________|
  307.                       |Status/Help Line                       |
  308.                        ---------------------------------------
  309.  
  310.  
  311.                                               Chapter 1:  Introduction    3
  312.  
  313.  
  314.           Elements of the PM Assistant display:          Elements of the PM Assistant display:          Elements of the PM Assistant display:
  315.  
  316.           Macro type          Macro type          Macro type -                       An abbreviation for one of the seven types of
  317.              macros:
  318.                SP   Start Program
  319.                PW   Position Window
  320.                MK   Mouse & Keyboard Input
  321.                KI   Keyboard Input
  322.                CO   Compound
  323.                GR   Group
  324.                CM   Customize Menu
  325.           Hot-key          Hot-key          Hot-key -                    A series of one or more keystrokes used to execute the
  326.              macro.
  327.  
  328.           Status/Help line          Status/Help line          Status/Help line -                             Displays PM Assistant's Status and Help
  329.              messages.
  330.  
  331.           Macro name          Macro name          Macro name -                       The name by which a macro is referred.
  332.  
  333.           Macro comment          Macro comment          Macro comment -                          Your descriptive comment.
  334.  
  335.  
  336.           The Status/Help Line          The Status/Help Line          The Status/Help Line
  337.  
  338.           The Status/Help line at the bottom of the PM Assistant display
  339.           informs you of PM Assistant's current status when executing a
  340.           macro or provides help information when accessing a pull-down
  341.           menu.
  342.  
  343.           While macros are executing, the status message `                                                                                                                   `                                                           Executing macro
  344.           `macroname''                                           '                        is displayed.  When PM Assistant is idle, the
  345.           Status line displays the message `                                                                                       `                                             Ready'                                                  '                                                   . When loading a macro
  346.           file into PM Assistant, the Status line displays                                                             `                                                           `                                                             Loading macro
  347.           file `filename''                                                   '                            and the percentage of the file loaded.  When
  348.           searching for a macro with the View Find command, the status line
  349.           reports on the success or failure of the search.
  350.           When you are accessing a pull-down menu, the Help line displays
  351.           the accelerator key for that command (if it has one), and a brief
  352.           descriptive message about the menu command.  Help lines are
  353.           displayed in the standard Help text color as set through PM
  354.           Control Panel.  (The default is blue.)  Status strings in the
  355.           Status/Help line are displayed in the standard foreground text
  356.           color as set through PM Control Panel.  (The default is black.)
  357.  
  358.           The Status/Help line can be suppressed to free up screen space
  359.           for the macro display; see Suppressing the Status/Help Line on
  360.           page 31.
  361.  
  362.  
  363.           On-line Help          On-line Help          On-line Help
  364.           Help is always available on-line.  You can get help in two ways:
  365.  
  366.  
  367.           4    PM Assistant User's Guide
  368.  
  369.  
  370.           >          >          >  While viewing the PM Assistant display, press F1 or choose
  371.              the Help                 Help                 Help menu commands.
  372.                This brings up the PM Assistant Help window with the
  373.                help index displayed.  The different Help                                                    Help                                                    Help menu commands
  374.                take you directly to different portions of the help
  375.                index.
  376.  
  377.           >          >          >  While viewing a dialog box, press F1 or click the Help                                                               Help                                                               Help
  378.              button.
  379.                This brings up context-sensitive help on the dialog box
  380.                you are viewing.
  381.  
  382.           The Help system is a single-level list of help topics. You can
  383.           browse through it using the index or the Help window's Next                                                                 Next                                                                 Next and
  384.           Prev          Prev          Prev menu commands.
  385.  
  386.  
  387.           Keyboard Interface          Keyboard Interface          Keyboard Interface
  388.  
  389.           The following keystrokes are recognized by PM Assistant:
  390.  
  391.           Press:          Press:          Press:      To do this:                      To do this:                      To do this:
  392.           F1          Bring up on-line Help.
  393.           ENTER       Execute the selected macro.
  394.           PG UP       Scroll the macro list back one page.
  395.           PG DOWN     Scroll the macro list forward one page.
  396.           HOME        Scroll to the beginning of the macro list.
  397.           END         Scroll to the end of the macro list.
  398.           UP ARROW    Move the macro selection up one line.
  399.           DOWN ARROW  Move the macro selection down one line.
  400.           LEFT ARROW  Select the first displayed macro.
  401.           RIGHT ARROW Scroll to the selected macro.
  402.  
  403.           PM Assistant's menu commands have accelerator keys associated
  404.           with them.  A command's accelerator key is displayed on the
  405.           Status/Help line while the menu command is selected.
  406.  
  407.  
  408.           Mouse Interface          Mouse Interface          Mouse Interface
  409.  
  410.           The following mouse actions are recognized by PM Assistant:
  411.  
  412.           Do this:          Do this:          Do this:                 To do this:                                   To do this:                                   To do this:
  413.           Click the left button    Select the macro under the mouse
  414.                                    pointer.
  415.           Double-click left button Execute the macro under the mouse
  416.                                    pointer.
  417.           Click the right button   Execute the Macro Settings command on
  418.                                    the macro under the mouse pointer.
  419.  
  420.  
  421.                                               Chapter 1:  Introduction    5
  422.  
  423.  
  424.           Document Notes          Document Notes          Document Notes
  425.  
  426.           This document assumes you are familiar with Presentation Manager
  427.           and how to use the various Presentation Manager controls such as
  428.           menu commands and dialog box buttons.  See your Presentation
  429.           Manager and OS/2 documentation for more information about
  430.           Presentation Manager.
  431.  
  432.           Terms          Terms          Terms
  433.  
  434.           The following terms are used in this manual and in PM Assistant:
  435.  
  436.           Accelerator key          Accelerator key          Accelerator key -                            A single keystroke which executes a menu
  437.              command.  Accelerator keys are provided by each application
  438.              and are not recognized outside the application.  (Contrast
  439.              with Hot-key).
  440.  
  441.           Choose          Choose          Choose -                   You choose menu commands.  For example:  Choose File                                                                   File                                                                   File
  442.              Open              Open              Open means to click the File                                      File                                      File menu on the menu bar, then click
  443.              the Open                 Open                 Open menu command in the displayed menu.  (Contrast with
  444.              Click and Select).
  445.  
  446.           Click          Click          Click -                  You click on buttons within dialog boxes to perform
  447.              actions.  You click by placing the mouse pointer over the
  448.              button and pressing the left mouse button.  You can also
  449.              `              `               click'                     '                       a button by pressing the TAB key until it gets the
  450.              focus (as indicated by a dotted line around the text of the
  451.              button) and pressing the SPACE bar.  You also click on other
  452.              areas of the screen to select or indicate items such as
  453.              macros in PM Assistant's display or other application's
  454.              windows.  (Contrast with Choose and Select).
  455.  
  456.           Desktop          Desktop          Desktop -                    The screen area when in the Presentation Manager
  457.              session (see Session).  Application's windows and icons are
  458.              said to be                          ``                          on top of'                                                                         ' and `                                                                                     `                                            moved about'                                                       '                                                         the desktop.
  459.  
  460.           Dialog box          Dialog box          Dialog box                       - A rectangular box that requests information such as
  461.              the settings for a macro.  (Contrast with Message box).
  462.  
  463.           Edit clipboard          Edit clipboard          Edit clipboard -                           A temporary storage area for macros being moved
  464.              with the Edit menu commands.  (Contrast with Menu clipboard).
  465.  
  466.           Environment Variable          Environment Variable          Environment Variable -                                 These are settings which control various
  467.              aspects of OS/2.  They can be set in the config.sys file or
  468.              with the SET command at an OS/2 command prompt.  For example,
  469.              the PATH environment variable tells OS/2 where to look on
  470.              your disk for programs to run.
  471.  
  472.           Foreground window          Foreground window          Foreground window -                              Also known as the active window                                                active window                                                active window, the window
  473.              you are currently using.
  474.  
  475.           Full-screen session          Full-screen session          Full-screen session                                - See Session.
  476.  
  477.  
  478.           6    PM Assistant User's Guide
  479.  
  480.  
  481.           Full pathname          Full pathname          Full pathname                          - Specifies the drive, directory and name of a
  482.              file.  For example, C:\pmasst\a_sample.pma is a full
  483.              pathname, whereas a_sample.pma is a filename.
  484.  
  485.           Hot-Key          Hot-Key          Hot-Key                    - A sequence of one or more keystrokes used to invoke PM
  486.              Assistant macros.  Hot-keys are provided by PM Assistant and
  487.              are recognized at all times, regardless of what window is in
  488.              the foreground.  (Contrast with Accelerator key).
  489.  
  490.           Icon          Icon          Icon                 - A graphic symbol that represents an application in its
  491.              minimized state.
  492.  
  493.           Input focus          Input focus          Input focus                        - Where keystrokes are sent.  The window with the
  494.              input focus is the Foreground window.
  495.  
  496.           Macro          Macro          Macro                  - A recorded action, or series of actions, that can be
  497.              activated by a hot-key or through the PM Assistant window.
  498.  
  499.           Menu          Menu          Menu                 - A list of commands found in the menu bar at the top of the
  500.              window.
  501.  
  502.           Menu clipboard          Menu clipboard          Menu clipboard                           - A temporary storage area for menu items being
  503.              moved from one menu to another with a series of Customize
  504.              Menu macros.
  505.  
  506.           Message Box          Message Box          Message Box                        - A rectangular box that displays information such as
  507.              warning messages.
  508.  
  509.           PM          PM          PM               - An abbreviation for Presentation Manager.  Presentation
  510.              Manager is the windowing system running on top of OS/2 and
  511.              provides a consistent interface to applications designed for
  512.              it.
  513.  
  514.           Process          Process          Process                    - Each program running on OS/2 is a process.  Each
  515.              process can be composed of one or more threads to handle
  516.              different computational tasks such as servicing user input,
  517.              reading the disk or paginating a document.
  518.  
  519.           Select          Select          Select                   - You select items to be operated upon by commands, such
  520.              as macro lines and check-boxes.
  521.  
  522.           Session          Session          Session                    - The environment in which you run your application.  The
  523.              Presentation Manager session is where all Presentation
  524.              Manager applications run.  A full-screen session is a program
  525.              started with a run mode = Full-Screen, and takes the entire
  526.              screen such as an OS/2 Full-Screen command prompt.
  527.  
  528.           Thread          Thread          Thread                   - The smallest unit of allocatable computational resource.
  529.              Each program running in OS/2 is made up of one or more
  530.              threads to handle different computational tasks such as
  531.              servicing user input, reading the disk or recalculating a
  532.              spreadsheet.
  533.  
  534.  
  535.                                               Chapter 1:  Introduction    7
  536.  
  537.  
  538.           Window          Window          Window                     - A bordered rectangular area on the screen which
  539.              represents an application's workspace.
  540.  
  541.  
  542.                                                     Chapter 2:  Macros    9
  543.  
  544.  
  545.  
  546.  
  547.           2          2          2    Macros               Macros               Macros
  548.  
  549.  
  550.           A macro is the basic unit of operation in PM Assistant.  A macro
  551.           records various actions you perform in Presentation Manager.  You
  552.           create, edit, rearrange and execute macros.  There are five types
  553.           of basic macros:  Start Program, Position Window, Mouse &
  554.           Keyboard Input, Keyboard Input, and Customize Menu.  There are
  555.           two types of macros that are made of other macros:  Compound and
  556.           Group.
  557.  
  558.           This chapter first describes how to create, change and execute
  559.           macros in general, then describes each of the seven types of
  560.           macros.
  561.  
  562.  
  563.           Creating Macros          Creating Macros          Creating Macros
  564.  
  565.           To create any type of macro:
  566.  
  567.           1. Choose Macro Create                    Macro Create                    Macro Create.
  568.                A menu appears with the list of macro types.
  569.  
  570.           2. Choose the type of macro you want to create from the menu.
  571.                The Macro Information dialog box appears.
  572.  
  573.           3. In the Name                    Name                    Name box, enter the name of your macro (optional).
  574.                Since macros are sometimes referred to by name from
  575.                other macros or the command line, you should enter a
  576.                unique name for every macro.
  577.  
  578.           4. In the Comment                    Comment                    Comment box, enter your own descriptive comments about
  579.              the macro (optional).
  580.  
  581.           5. In the Hot-key                    Hot-key                    Hot-key box, enter the keystrokes you will use to
  582.              execute the macro (optional).
  583.                The hot-key can be any number of keystrokes long.  Type
  584.                the keystrokes just as you would enter them when
  585.                executing the macro, i.e. press the CTRL key and the F5
  586.                key together to create the combination CTRL+F5.  The
  587.                BACKSPACE key will clear the Hot-key                                            Hot-key                                            Hot-key box, as does the
  588.                Clear Hot-key               Clear Hot-key               Clear Hot-key button.  The TAB key moves the focus to
  589.                the next dialog box item (the Settings                                             Settings                                             Settings button).  You
  590.                can include the BACKSPACE and TAB keys in a Hot-key if
  591.                desired, see Macro Options on page 25.
  592.  
  593.           6. Click the Settings                       Settings                       Settings button.
  594.  
  595.           7. Set the settings for the particular type of macro.
  596.  
  597.           8. Click the OK                       OK                       OK button.
  598.                The macro appears selected in the PM Assistant display.
  599.  
  600.  
  601.           10   PM Assistant User's Guide
  602.  
  603.  
  604.           When creating or changing the settings of any macro, the Macro
  605.           Information dialog box appears first where you enter the name,
  606.           comment and hot-key attributes.  Next, click the Settings                                                           Settings                                                           Settings button
  607.           to set attributes specific for each type of macro.  Group and
  608.           Compound macros have no other attributes, thus the Settings                                                             Settings                                                             Settings
  609.           button will be grayed.  Click the Done                                            Done                                            Done button to dismiss the
  610.           Macro Information dialog box and return to the PM Assistant
  611.           display.
  612.  
  613.  
  614.           Changing Macro Settings          Changing Macro Settings          Changing Macro Settings
  615.  
  616.           You can view or change the attributes associated with a macro
  617.           (its name, the action it records...) in two ways:
  618.  
  619.           1. Select the macro to change.
  620.  
  621.           2. Choose Macro Settings                    Macro Settings                    Macro Settings.
  622.  
  623.              or
  624.  
  625.           >          >          >  Click on the macro to change with the right mouse button.
  626.  
  627.           The Macro Information dialog box will appear with the macro's
  628.           current settings.  Make any changes you desire.  Click the
  629.           Settings          Settings          Settings, Done                    Done                    Done or Cancel                            Cancel                            Cancel buttons to view more settings, return to
  630.           PM Assistant, or discard any changes, respectively.
  631.  
  632.  
  633.           Executing Macros          Executing Macros          Executing Macros
  634.  
  635.           You can execute a macro in three ways:  from the PM Assistant
  636.           display, with the Macro Execute                            Macro Execute                            Macro Execute command, or by typing the macro's
  637.           hot-key.
  638.  
  639.           To execute a macro from the PM Assistant display:
  640.  
  641.           >          >          >  Double-click the macro display line for the desired macro.
  642.              or
  643.  
  644.           1. Select the macro you want to execute.
  645.  
  646.           2. Press ENTER.
  647.  
  648.           To execute a macro with a hot-key:
  649.  
  650.           >          >          >  Type the hot-key assigned to the macro.
  651.                Hot-keys can be used in the Presentation Manager
  652.                session or in any full-screen session started by PM
  653.                Assistant with a Start Program macro.
  654.  
  655.           To execute a macro with the Macro Execute                                      Macro Execute                                      Macro Execute command:
  656.  
  657.           1. Select the macro you want to execute.
  658.  
  659.  
  660.                                                     Chapter 2:  Macros   11
  661.  
  662.  
  663.           2. Choose Macro Execute                    Macro Execute                    Macro Execute.
  664.                The Macro Execute                   Macro Execute                   Macro Execute command has several options such as
  665.                executing a macro repeatedly.  See Macro Execute
  666.                Command on page 24.
  667.  
  668.  
  669.           Start Program Macro          Start Program Macro          Start Program Macro
  670.  
  671.           A Start Program macro starts a program similarly to the Start
  672.           Programs application provided with PM.  The advantage to using
  673.           the Start Program macro rather than the Start Programs
  674.           application is that in one step you can start the program,
  675.           specify the initial process priority, and size and place the
  676.           program's window.
  677.  
  678.  
  679.           To create a Start Program macro:
  680.  
  681.           1. Choose Macro Create                    Macro Create                    Macro Create.
  682.  
  683.           2. Choose Start Programs                    Start Programs                    Start Programs.
  684.  
  685.           3. Enter the macro name, comment, and hot-key in the Macro
  686.              Information dialog box.
  687.  
  688.           4. Click the Settings                       Settings                       Settings button.
  689.                The Start Program dialog box appears.
  690.  
  691.           5. Enter in the Command line                          Command line                          Command line box the name of the program file
  692.              you wish to execute followed by any parameters.
  693.                As with the Start Programs application, if the
  694.                parameters are a question mark (?) you will be prompted
  695.                to supply the parameters each time the macro is
  696.                executed.  If the program is not in a directory
  697.                included in the Path environment variable, you must
  698.                supply the full pathname for the program.
  699.  
  700.           6. Enter in the Initial directory                          Initial directory                          Initial directory box the directory in which to
  701.              start the program (optional).
  702.  
  703.           7. Select in the Program run method                           Program run method                           Program run method box how PM Assistant should
  704.              start the program (optional).
  705.                After you have entered the command line, PM Assistant
  706.                determines how the program may be run and enables those
  707.                buttons:
  708.              *             *             * PM program               PM program               PM program                            - A program which uses the Presentation
  709.                Manager interface such as PM Assistant or the File
  710.                System application.
  711.              *             *             * PM text window               PM text window               PM text window                                - A program which uses a character
  712.                oriented interface and can run in a PM text window such
  713.                as the windowed OS/2 command prompt.  These programs
  714.                can also be run in a full-screen session if you prefer.
  715.              *             *             * full-screen               full-screen               full-screen                             - A program which must run in a character
  716.                oriented full-screen session.
  717.  
  718.  
  719.           12   PM Assistant User's Guide
  720.  
  721.  
  722.           8. Select in the Initial process priority                           Initial process priority                           Initial process priority box the priority level
  723.              PM Assistant should assign the program (optional).
  724.                For a discussion of these attributes, see Process
  725.                Priorities on page 37.
  726.  
  727.           9. Enter in the Macro specifying initial position                          Macro specifying initial position                          Macro specifying initial position box the name
  728.              of the Position Window macro which specifies the initial
  729.              position of the program being started (optional).
  730.                If this setting is left blank, PM assistant starts the
  731.                program in a default position, filling most of the
  732.                screen.
  733.  
  734.           10.Select the Wait for program to end before continuing                        Wait for program to end before continuing                        Wait for program to end before continuing box to
  735.              cause PM Assistant to wait for the program to end before
  736.              executing more macros.
  737.                In general, this box should be left unchecked.  If
  738.                checked, PM Assistant will stop executing macros until
  739.                the program terminates (if you direct PM Assistant to
  740.                execute a macro that macro will be queued).  This is
  741.                typically used when the Start Program macro is in the
  742.                body of a Compound macro and execution of the rest of
  743.                the Compound macro needs to be delayed until the
  744.                program ends.
  745.  
  746.            You can create Start Program macros directly based on program
  747.           information stored in the Start Programs application, see
  748.           Building Sets of Macros on page 23.
  749.  
  750.           HINT:
  751.           You can have a Position Window macro (see following section)
  752.           execute a Start Program macro to start a program if it's not
  753.           already running.  This way you can have a hot-key associated with
  754.           a Position Window macro which brings a program to the foreground,
  755.           and if the program is not running it is started automatically.
  756.  
  757.  
  758.           Position Window Macro          Position Window Macro          Position Window Macro
  759.  
  760.           A Position Window macro can move, size, minimize, maximize, or
  761.           put in the foreground any window or session just as the commands
  762.           of the system menu do.  A Position Window macro is typically used
  763.           to move program windows where you want them.  You can use hot-
  764.           keys to quickly switch between applications by creating a
  765.           Position Window macro for each application.
  766.  
  767.           You can create a set of Position Window macros which save and
  768.           restore the positions of all windows automatically, see Building
  769.           Sets of Macros on page 23.
  770.  
  771.  
  772.           To create a Position Window Macro:
  773.  
  774.           1. Choose Macro Create                    Macro Create                    Macro Create.
  775.  
  776.  
  777.                                                     Chapter 2:  Macros   13
  778.  
  779.  
  780.           2. Choose Position Window                    Position Window                    Position Window.
  781.  
  782.           3. Enter the macro name, comment, and hot-key in the Macro
  783.              Information dialog box.
  784.  
  785.           4. Click the Settings                       Settings                       Settings button.
  786.                The Position Window dialog box appears.
  787.  
  788.           5. Select a combination of the following options:
  789.              *             *             * Size window               Size window               Size window                             - Sizes the indicated window to the desired
  790.                size.
  791.              *             *             * Move window               Move window               Move window                             - Moves the indicated window to the desired
  792.                position.
  793.              *             *             * Give window the input focus               Give window the input focus               Give window the input focus                                             - Brings the indicated
  794.                window to the foreground.
  795.              *             *             * Restore window               Restore window               Restore window                                - Restores the indicated window to its
  796.                non-iconic, non-maximized size and position.
  797.              *             *             * Minimize window               Minimize window               Minimize window                                 - Replaces the indicated window with
  798.                its icon at the bottom of the PM desktop.
  799.              *             *             * Maximize window               Maximize window               Maximize window                                 - Positions and sizes the indicated
  800.                window so that it takes up the entire PM desktop.
  801.  
  802.           6. Select the If window does not exist                        If window does not exist                        If window does not exist settings to tell PM
  803.              Assistant what to do if it cannot find the window to
  804.              position.  For example, it would not be able to find the
  805.              window if you were not running the program when you executed
  806.              the Position Window macro.
  807.              *             *             * First wait...seconds, then               First wait...seconds, then               First wait...seconds, then                                            - PM Assistant waits the
  808.                specified number of seconds for the indicated window to
  809.                appear.  This is useful when this Position Window macro
  810.                is called by a Start Program macro that requires some
  811.                time to draw the application's window.
  812.              *             *             * Start program with macro:               Start program with macro:               Start program with macro:                                           - PM Assistant starts the
  813.                program with the named macro.  The macro need not be a
  814.                Start Program macro but could be a Compound macro that
  815.                performs various initializations as well as just
  816.                starting the desired program.
  817.              *             *             * Give a warning               Give a warning               Give a warning                                - PM Assistant brings up a warning
  818.                message box.
  819.              *             *             * Continue without warning               Continue without warning               Continue without warning                                          - PM Assistant ignores the
  820.                error and does not give a warning message box.
  821.           7. Select one of the two options in the Window to position                                                  Window to position                                                  Window to position box:
  822.              *             *             * Foreground window               Foreground window               Foreground window                                   - PM Assistant positions the window
  823.                which is in the foreground at the time the macro is
  824.                executed.
  825.              *             *             * Indicated window               Indicated window               Indicated window                                  - PM Assistant positions the window
  826.                which is pointed to in step 8.
  827.  
  828.  
  829.           14   PM Assistant User's Guide
  830.  
  831.  
  832.           8. If the Move                    Move                    Move, Size                          Size                          Size or Indicated window                                  Indicated window                                  Indicated window boxes are checked,
  833.              click the Point                       Point                       Point button and click on a window to indicate
  834.              which window you want positioned.
  835.                You can also click on the icon of a window.  Clicking
  836.                on the icon of a full-screen session makes that session
  837.                the window to position.  In this way you can create a
  838.                Position Window macro which brings a particular full-
  839.                screen session to the foreground.
  840.  
  841.                If you do not have a mouse, the window just below PM
  842.                Assistant is treated as the window to position.
  843.  
  844.           NOTE:
  845.           If more than one copy of the same program is running, PM
  846.           Assistant assigns a number to each copy and uses that number to
  847.           identify the corresponding window.  You can make sure the
  848.           numbering is consistent each time the programs are run by
  849.           starting the programs with PM Assistant.  If the programs are
  850.           already started when PM Assistant is run, the numbers are
  851.           assigned arbitrarily.
  852.  
  853.           The numbering may cause apparently spurious `                                                                                                             `                                                        Cannot find
  854.           window'                                 '                   error messages when executing Position Window macros
  855.           which target multiple copies of the same program.  For example,
  856.           you might have two copies of the OS/2 windowed command prompt
  857.           running and create a Position Window macro to position one of the
  858.           copies.  If you later execute the macro with only one copy of the
  859.           OS/2 windowed command prompt running,  PM Assistant might report
  860.           a `                         `              Cannot find window'                                '                                  error because it had identified the OS/2
  861.           command prompt window to position as the 2nd copy.
  862.  
  863.  
  864.           Mouse & Keyboard Input Macro          Mouse & Keyboard Input Macro          Mouse & Keyboard Input Macro
  865.  
  866.           A Mouse & Keyboard Input macro allows you to record your mouse
  867.           and keyboard input and then play back those same mouse movements
  868.           and keystrokes.  A frequent use of these macros is to record your
  869.           initial operations to set up an application prior to using it.
  870.           For example, you may record the actions necessary to load your
  871.           usual file into an application and to initialize options the way
  872.           you like.  The playback of these macros can be sped up so it
  873.           takes very little time to initialize your application.
  874.  
  875.           Mouse & Keyboard Input macros can only be used in the PM session.
  876.           PM Assistant cannot record or play back mouse movements in a
  877.           full-screen session.  Keyboard Input macros can play keystrokes
  878.           in a full-screen session, see Keyboard Input Macro on page 17.
  879.  
  880.           To create a Mouse & Keyboard Input macro:
  881.  
  882.           1. Choose Macro Create                    Macro Create                    Macro Create.
  883.  
  884.           2. Choose Mouse & Keyboard Input                    Mouse & Keyboard Input                    Mouse & Keyboard Input.
  885.  
  886.  
  887.                                                     Chapter 2:  Macros   15
  888.  
  889.  
  890.           3. Enter the macro name, comment, and hot-key in the Macro
  891.              Information dialog box.
  892.  
  893.           4. Click the Settings                       Settings                       Settings button.
  894.                The Mouse and Keyboard Input dialog box appears.
  895.  
  896.           5. Enter a setting in the Playback rate                                    Playback rate                                    Playback rate box.
  897.                This is the speed at which the mouse movements and
  898.                keystrokes are to be played back.  A setting of 1 means
  899.                the same speed as recorded.  A setting of .5 means at
  900.                one half the recorded speed, a setting of 3 means
  901.                speeded up to three times the recorded speed.  A
  902.                setting of Max                          Max                          Max plays it back as fast as possible.  You
  903.                can use either the scroll-bar to set the speed or you
  904.                can enter any number in the edit field.
  905.  
  906.           6. Check the Discard button-up mouse movements                       Discard button-up mouse movements                       Discard button-up mouse movements box if you do not
  907.              wish to record movement of the mouse made with the button up.
  908.                This check box indicates not to bother recording the
  909.                often unnecessary movements of the mouse made with the
  910.                buttons unpressed.  Enabling this option can save
  911.                significant space for recording the macro and can make
  912.                the maximum playback rate much higher.  Some
  913.                applications, however, may require these movements to
  914.                be recorded to play back correctly; and if the playback
  915.                is to be used as a demo, the playback will be more
  916.                intuitive to the audience if they can see all of the
  917.                mouse movements.
  918.  
  919.           7. Check the Confirm window receiving button clicks                       Confirm window receiving button clicks                       Confirm window receiving button clicks box if you
  920.              want PM Assistant to monitor what windows are clicked on when
  921.              the macro is recorded and executed.
  922.                PM Assistant will then abort any macro which plays a
  923.                button click back to a different window than when the
  924.                macro was recorded.  This can prevent macros from
  925.                `                               `                 running amok'                             '                               if conditions change during execution.
  926.                For example, if a window the macro intends to access is
  927.                obscured during execution, this option will abort the
  928.                macro before it sends the button clicks to the
  929.                (unintended) obscuring window.
  930.  
  931.           8. Click the Record                       Record                       Record button to begin recording mouse & keyboard
  932.              input.
  933.                The Recording `macroname' dialog box appears at the
  934.                lower left of your screen.
  935.  
  936.  
  937.           16   PM Assistant User's Guide
  938.  
  939.  
  940.           9. To pause recording your macro at any time, click the Pause                                                                  Pause                                                                  Pause
  941.              button.
  942.                While in Paused mode, you can enter a prompt into the
  943.                entry field of the dialog box.  Then when you execute
  944.                the macro that text will be displayed in the dialog box
  945.                when the pause is reached.  Such pauses are generally
  946.                used to let the user enter some information to an
  947.                application which may change each time the macro is
  948.                executed.  Or the pause can be used to let the user
  949.                inspect a graph or data in the application prior to
  950.                continuation.
  951.  
  952.           10.To stop recording, click the Stop                                          Stop                                          Stop button or type CTRL+C.
  953.  
  954.           When recording a Mouse & Keyboard Input macro you may want to
  955.           maximize the application window you are working with.  This will
  956.           obscure the Recording `macroname' dialog box, however, and make
  957.           it difficult to add pauses to the macro.  You can overcome this
  958.           by giving the Recording `macroname' dialog box a hot-key, which
  959.           when typed, brings the dialog box to the foreground.  For
  960.           information about setting the Recording `macroname' dialog box
  961.           hot-key, see Macro Options on page 26.
  962.  
  963.           When the macro is executed, an Executing `macroname' dialog box
  964.           appears in the same place and with the same controls as the
  965.           Recording `macroname' dialog box.  During execution the macro can
  966.           be aborted at any time by typing CTRL+C.
  967.  
  968.           NOTE:
  969.           When executing a macro with the demonstration utility, the
  970.           Executing `macroname' dialog box will not appear, so do not put
  971.           pauses in such macros.  For information about the demonstration
  972.           utility see Demonstration Utility on page 43.
  973.  
  974.           Mouse & Keyboard Input macros can operate on PM Assistant with
  975.           the following restrictions:
  976.  
  977.            -           -           -You may not create, edit or delete any macros.
  978.            -           -           -You may not discard the current macro list by choosing File                                                                   File                                                                   File
  979.             New            New            New or File Open                   File Open                   File Open commands.
  980.  
  981.           You may disable/enable macros, change any of the Control                                                           Control                                                           Control
  982.           settings, or execute other macros (including other Mouse &
  983.           Keyboard Input macros).   To execute another macro while
  984.           recording/playing a Mouse & Keyboard Input macro you must type
  985.           the macro's hot-key.  Double clicking on a macro in PM Assistant
  986.           while recording a MK macro will queue the macro to be executed
  987.           later.
  988.  
  989.           HINTS:
  990.           It is suggested that you break a long Mouse & Keyboard Input
  991.           macro into several shorter macros which you combine in a Compound
  992.           macro.  In this way, re-recording a portion of a macro will be
  993.           easier.
  994.  
  995.  
  996.                                                     Chapter 2:  Macros   17
  997.  
  998.  
  999.           Since mouse movements are recorded and played relative to the
  1000.           entire screen, placement of windows operated on by mouse input
  1001.           must be the same when playing the macro as when the macro was
  1002.           recorded.  For this reason, it is also suggested that you build a
  1003.           Compound macro which contains Position Window macros to position
  1004.           all the windows which are operated on.  By putting the Mouse &
  1005.           Keyboard Input macro at the end of this Compound macro, you can
  1006.           be sure all windows will be in the proper position every time the
  1007.           macro is executed.  For an easy way to create such Position
  1008.           Window macros, see Building Sets of Macros on page 23.
  1009.  
  1010.           PM Assistant Mouse & Keyboard Input macros are portable between
  1011.           systems with different screen resolutions.  For a macro to work
  1012.           properly, you should never access a portion of the screen outside
  1013.           the area of the lowest resolution screen it is to run on.  To
  1014.           facilitate this, PM Assistant can limit the resolution (i.e., the
  1015.           screen area) of recorded mouse movements.  See Macro Options on
  1016.           page 26.
  1017.  
  1018.           Also, the position where dialog boxes appear can vary depending
  1019.           on the screen resolution of the system.  Dialog boxes are placed
  1020.           such that they are completely within the screen boundaries, which
  1021.           vary between systems with different screen resolutions.  Message
  1022.           boxes are placed in the exact middle of the screen.  Therefore,
  1023.           for maximum macro portability, keep to the lower left portion of
  1024.           the screen and use the keyboard when interacting with dialog and
  1025.           message boxes.
  1026.  
  1027.  
  1028.           Keyboard Input Macro          Keyboard Input Macro          Keyboard Input Macro
  1029.  
  1030.           The Keyboard Input macro allows you to record and play back
  1031.           keystrokes.  It is more convenient to record keystrokes with the
  1032.           Keyboard Input macro than with the Mouse & Keyboard Input macro
  1033.           since you enter the keystrokes directly into a dialog box rather
  1034.           than starting and stopping a recording.  Unlike Mouse & Keyboard
  1035.           Input macros, you can direct the keystrokes to be played to any
  1036.           window, including any full-screen session started by PM
  1037.           Assistant.  However, a Keyboard Input macro cannot be used to run
  1038.           another macro with a hot-key.
  1039.  
  1040.  
  1041.           To create a Keyboard Input macro:
  1042.  
  1043.           1. Choose Macro Create                    Macro Create                    Macro Create.
  1044.  
  1045.           2. Choose Keyboard Input                    Keyboard Input                    Keyboard Input.
  1046.  
  1047.           3. Enter the macro name, comment, and hot-key in the Macro
  1048.              Information dialog box.
  1049.  
  1050.           4. Click the Settings                       Settings                       Settings button.
  1051.                The Keyboard Input dialog box appears.
  1052.  
  1053.  
  1054.           18   PM Assistant User's Guide
  1055.  
  1056.  
  1057.           5. Enter in the Keystrokes                          Keystrokes                          Keystrokes box the keystrokes to be played back.
  1058.                This entry field behaves just like the Hot-key                                                      Hot-key                                                      Hot-key entry
  1059.                field of the Macro Information dialog box.  Type the
  1060.                keystrokes just as you would in entering them in use,
  1061.                i.e. type the ALT key and the Q key together to create
  1062.                the combination ALT+Q.  The BACKSPACE key will clear
  1063.                the Keystrokes                   Keystrokes                   Keystrokes box, as does the Clear keystrokes                                               Clear keystrokes                                               Clear keystrokes
  1064.                button.  The TAB key moves the focus to the next dialog
  1065.                box item (the Indicated window                             Indicated window                             Indicated window option).  You can
  1066.                include the BACKSPACE and TAB keys in a Keyboard Input
  1067.                macro if desired, see Macro Options on page 25.
  1068.  
  1069.           6. Set the Play keystrokes to                     Play keystrokes to                     Play keystrokes to options:
  1070.              *             *             * Indicated window               Indicated window               Indicated window                                  - Allows you to point to a specific
  1071.                window which is to receive the keystrokes when the
  1072.                macro is executed.
  1073.              *             *             * Foreground window               Foreground window               Foreground window                                   - Plays the keystrokes to whichever
  1074.                window is in the foreground when the macro is executed.
  1075.  
  1076.           7. If the Indicated window                    Indicated window                    Indicated window option is set, choose the Point                                                               Point                                                               Point
  1077.              button and point to the window or icon in which you want the
  1078.              keystrokes to be played.
  1079.                If you point to the iconic representation of a full-
  1080.                screen session, the keystrokes are played to that
  1081.                session.  You can only play keystrokes to full-screen
  1082.                sessions started with PM Assistant Start Program
  1083.                macros.
  1084.  
  1085.           NOTE:
  1086.           While you can play keystrokes to a full-screen session which is
  1087.           not in the foreground, some applications require access to the
  1088.           screen to process the keystrokes, so they may not react until you
  1089.           switch to that session.  For example, you can play the keystrokes
  1090.           to execute an editor, but that editor may not load the file and
  1091.           display itself until you switch to that screen group.
  1092.  
  1093.  
  1094.           Group and Compound Macros          Group and Compound Macros          Group and Compound Macros
  1095.  
  1096.           There are two types of macros made up of other macros:  Group and
  1097.           Compound.
  1098.  
  1099.           A Compound macro contains a set of macros that will play
  1100.           sequentially when the Compound macro is executed.  For example, a
  1101.           Compound macro could be used to start and initialize a program by
  1102.           collecting all the necessary macros together: A Start Program
  1103.           macro to start the program, then a Mouse & Keyboard Input macro
  1104.           to load the right file into the program, followed by a set of
  1105.           Customize Menu macros to rearrange and set accelerator keys for
  1106.           that program.  A Compound macro can contain other Compound
  1107.           macros.  You can stop the execution of a Compound macro at any
  1108.           time by typing CTRL+C.  The display of the macros within a
  1109.           Compound macro can be expanded and collapsed, see Expanding and
  1110.           Collapsing Macros on page 29.
  1111.  
  1112.  
  1113.                                                     Chapter 2:  Macros   19
  1114.  
  1115.  
  1116.           A Group macro can be expanded, collapsed, and nested like a
  1117.           Compound macro, but it cannot be executed.  A Group macro is used
  1118.           for collecting related macros together which are not intended to
  1119.           be executed sequentially.
  1120.  
  1121.           To create a Group or Compound macro:
  1122.  
  1123.           1. Choose Macro Create                    Macro Create                    Macro Create.
  1124.  
  1125.           2. Choose Group                    Group                    Group or Compound                             Compound                             Compound.
  1126.  
  1127.           3. Enter the macro name, comment, and hot-key in the Macro
  1128.              Information dialog box.
  1129.                Since Group macros cannot be executed, the hot-key
  1130.                field will be disabled when creating a Group macro.
  1131.  
  1132.           4. Click the Done                       Done                       Done button.
  1133.                Since Group and Compound macros have no other settings,
  1134.                the Settings                   Settings                   Settings button of the Macro Information dialog box
  1135.                is disabled.
  1136.  
  1137.  
  1138.           To insert macros into a Group or Compound macro:
  1139.  
  1140.           1. Select the Group or Compound macro.
  1141.  
  1142.           2. If it is collapsed, expand it (see Expanding and Collapsing
  1143.              Macros on page 29).
  1144.                If the Group or Compound macro were left collapsed, the
  1145.                inserted macro would be placed after it rather than in
  1146.                it.  You don't need to expand newly created Group or
  1147.                Compound macros since they are expanded by default.
  1148.  
  1149.           3. Create or paste the macro to insert with the Macro Create                                                          Macro Create                                                          Macro Create or
  1150.              Edit Copy             Edit Copy             Edit Copy commands (see Editing Macro Listings on page 27).
  1151.                The inserted macro will appear in the macro list
  1152.                display below the Group or Compound macro, slightly
  1153.                indented and bounded by a delimiting bracket.
  1154.  
  1155.  
  1156.           Customize Menu Macro          Customize Menu Macro          Customize Menu Macro
  1157.  
  1158.           A Customize Menu macro changes the arrangement, text, or
  1159.           accelerator keys of any application's menu.  Often applications
  1160.           have your most frequently used commands near the bottom of their
  1161.           menus which can make it more tedious to choose those commands.
  1162.           With a Customize Menu macro you can move menu commands to the top
  1163.           of any pull-down menus.  Or perhaps a frequently executed command
  1164.           has an awkward or even no accelerator key associated with it.
  1165.           With a Customize Menu macro you can assign your own accelerator
  1166.           keys to menu commands and you can change the text of any command
  1167.           to be more meaningful to you.  In the following discussions menu
  1168.           commands which are being customized are referred to as menu items
  1169.           to distinguish them from PM Assistant's menu commands.
  1170.  
  1171.  
  1172.           20   PM Assistant User's Guide
  1173.  
  1174.  
  1175.           Changing the arrangement of menu items makes use of the Menu
  1176.           clipboard.  The Menu clipboard is a temporary storage location
  1177.           within PM Assistant which records all the information about a
  1178.           menu item.  For example, to move a menu item from one menu to
  1179.           another requires a Customize Menu macro to cut the menu item to
  1180.           the Menu clipboard, and another Customize Menu macro to paste the
  1181.           menu item from the Menu clipboard to the new position in the
  1182.           application's menus.  PM Assistant's Menu clipboard is not the
  1183.           same as the Presentation Manager clipboard.
  1184.  
  1185.           You can perform the same operations on entire menus (i.e., an
  1186.           entire list of menu items, such as the File                                                 File                                                 File drop-down menu) as
  1187.           you do menu items (such as the File Open                                         File Open                                         File Open menu item).  You can
  1188.           create submenus out of main menus.  For example, you could move
  1189.           the entire File                     File                     File menu into the Edit                                        Edit                                        Edit menu.  You would then choose
  1190.           Edit File Open          Edit File Open          Edit File Open.  PM Assistant's Macro Create                                          Macro Create                                          Macro Create and Control Invoke                                                           Control Invoke                                                           Control Invoke
  1191.           are examples of submenus.
  1192.  
  1193.           The changes made to an application's menus are only in effect for
  1194.           that instance of the application; the next time you start the
  1195.           application it will have its original menus.  Therefore it is
  1196.           suggested you create Compound macros which both start the
  1197.           application and customizes the menus.
  1198.  
  1199.           As an example, we will manipulate the menus of the DiskWatch
  1200.           application provided with PM Assistant.
  1201.  
  1202.           To cut, copy, or delete a menu item:
  1203.  
  1204.           1. Choose Macro Create                    Macro Create                    Macro Create.
  1205.  
  1206.           2. Choose Customize Menu                    Customize Menu                    Customize Menu.
  1207.  
  1208.           3. Enter the macro name, comment, and hot-key in the Macro
  1209.              Information dialog box.
  1210.  
  1211.           4. Click the Settings                       Settings                       Settings button.
  1212.                The Customize Menu dialog box appears.
  1213.  
  1214.           6. Select the option you wish to perform:
  1215.              *             *             * Cut               Cut               Cut                     - removes the menu item from the application's menu
  1216.                and places it on the Menu clipboard.
  1217.              *             *             * Copy               Copy               Copy                      - copies a menu item to the Menu clipboard.
  1218.              *             *             * Delete               Delete               Delete                        - removes the menu item from the application's
  1219.                menu.
  1220.  
  1221.           7. Click the Choose                        Choose                        Choose button.
  1222.                The Choose Menu Item dialog box appears.
  1223.  
  1224.           8. Choose the menu item in the application window that you wish
  1225.              to change.
  1226.                Even though you choose the menu command as you normally
  1227.                would to execute the menu command, it will not be
  1228.                executed by the application.
  1229.  
  1230.  
  1231.                                                     Chapter 2:  Macros   21
  1232.  
  1233.  
  1234.           9. Or, to choose an entire menu, display the menu (by clicking
  1235.              on it) and type ESC to dismiss the menu.  Click the OK                                                                 OK                                                                 OK button
  1236.              in the Choose Menu Item dialog box.
  1237.                The Customize Menu dialog box returns with the selected
  1238.                menu item in the Chosen menu                                Chosen menu                                Chosen menu box.
  1239.  
  1240.           10.Click the OK                        OK                        OK button.
  1241.  
  1242.  
  1243.           To insert a menu item:
  1244.  
  1245.           1. Choose Macro Create                    Macro Create                    Macro Create.
  1246.  
  1247.           2. Choose Customize Menu                    Customize Menu                    Customize Menu.
  1248.  
  1249.           3. Enter the macro name, comment, and hot-key in the Macro
  1250.              Information dialog box.
  1251.  
  1252.           4. Click the Settings                       Settings                       Settings button.
  1253.                The Customize Menu dialog box appears.
  1254.  
  1255.           5. Select Paste menu command from menu clipboard                    Paste menu command from menu clipboard                    Paste menu command from menu clipboard.
  1256.  
  1257.           6. Click the Choose                       Choose                       Choose button.
  1258.                The Choose Menu Item dialog box appears.
  1259.  
  1260.           7. Choose the menu item in the application window after which
  1261.              you wish to insert the menu item from the menu clipboard.
  1262.                Even though you choose the menu command as you normally
  1263.                would to execute the menu command, it will not be
  1264.                executed by the application
  1265.  
  1266.                The Customize Menu dialog box returns with the chosen
  1267.                menu item in the Chosen menu                                Chosen menu                                Chosen menu box.
  1268.  
  1269.           8. Click the OK                       OK                       OK button.
  1270.  
  1271.           You must execute a Customize Menu macro which cuts or copies a
  1272.           menu item to the Menu clipboard before executing a Customize Menu
  1273.           macro which pastes a menu item from the Menu clipboard.
  1274.           You can combine the cut/copy macro with the insert macro in a
  1275.           Compound macro to move a menu item in one step.
  1276.  
  1277.  
  1278.           To rename a menu or submenu item:
  1279.  
  1280.           1. Choose Macro Create                    Macro Create                    Macro Create.
  1281.  
  1282.           2. Choose Customize Menu                    Customize Menu                    Customize Menu.
  1283.  
  1284.           3. Enter the macro name, comment, and hot-key in the Macro
  1285.              Information dialog box.
  1286.  
  1287.           4. Click the Settings                       Settings                       Settings button.
  1288.  
  1289.  
  1290.           22   PM Assistant User's Guide
  1291.  
  1292.  
  1293.           5. Select Set menu text                    Set menu text                    Set menu text and enter the new menu item text.
  1294.  
  1295.           6. Click the Choose                       Choose                       Choose button.
  1296.                The Choose Menu Item dialog box appears.
  1297.  
  1298.           7. Choose the menu item in the application window that you wish
  1299.              to change.
  1300.                Even though you choose the menu command as you normally
  1301.                would to execute the menu command, it will not be
  1302.                executed by the application.
  1303.  
  1304.                The Customize Menu dialog box returns with the selected
  1305.                menu item in the Chosen menu                                Chosen menu                                Chosen menu box.
  1306.  
  1307.           8. Click the OK                       OK                       OK button.
  1308.  
  1309.           9. Execute the macro and examine the application menu to see
  1310.              that the menu has been changed.
  1311.  
  1312.           To assign an accelerator key to a menu item:
  1313.  
  1314.           1. Choose Macro Create                    Macro Create                    Macro Create.
  1315.  
  1316.           2. Choose Customize Menu                    Customize Menu                    Customize Menu.
  1317.  
  1318.           3. Enter the macro name, comment, and hot-key in the Macro
  1319.              Information dialog box.
  1320.  
  1321.           4. Click the Settings                       Settings                       Settings button.
  1322.  
  1323.           5. Select Set accelerator key                    Set accelerator key                    Set accelerator key and enter the new  accelerator
  1324.              key.
  1325.                Press the actual key, just as you would type it in
  1326.                actual use.  Unlike hot-keys, an accelerator key can
  1327.                only be one keystroke long.
  1328.  
  1329.           6. Click the Choose                       Choose                       Choose button.
  1330.                The Choose Menu Item dialog box appears.
  1331.  
  1332.           7. Choose the menu item in the application window that you wish
  1333.              to change.
  1334.                Even though you choose the menu command as you normally
  1335.                would to execute the menu command, it will not be
  1336.                executed by the application.
  1337.  
  1338.                The Customize Menu dialog box returns with the selected
  1339.                menu item in the Chosen menu                                Chosen menu                                Chosen menu box.
  1340.  
  1341.           8. Click the OK                       OK                       OK button.
  1342.  
  1343.  
  1344.                                                     Chapter 2:  Macros   23
  1345.  
  1346.  
  1347.           Building Sets of Macros          Building Sets of Macros          Building Sets of Macros
  1348.  
  1349.           The Macro Build              Macro Build              Macro Build commands create common sets of macros
  1350.           automatically.  The Macro Build                              Macro Build                              Macro Build commands are Desktop Arrangement                                                       Desktop Arrangement                                                       Desktop Arrangement
  1351.           and Start Programs Group              Start Programs Group              Start Programs Group.
  1352.  
  1353.           A Desktop Arrangement macro is a Compound macro made up of
  1354.           Position Window macros for each window currently on the desktop.
  1355.           In this way you can save the current desktop arrangement and
  1356.           restore it later by executing the Compound macro.
  1357.  
  1358.           To build a Desktop Arrangement Compound macro:
  1359.  
  1360.           1. Arrange the desktop the way you want it.
  1361.  
  1362.           2. Choose Macro Build                    Macro Build                    Macro Build.
  1363.  
  1364.           3. Choose Desktop Arrangement                    Desktop Arrangement                    Desktop Arrangement.
  1365.  
  1366.           4. Enter the macro name, comment, and hot-key in the Macro
  1367.              Information dialog box for the Compound macro to be built.
  1368.  
  1369.           5. Click the OK                       OK                       OK button.
  1370.                The body of the Compound macro is filled with Position
  1371.                Window macros, one for each window on the desktop.
  1372.  
  1373.  
  1374.           A Start Programs Group macro is a Group macro composed of Start
  1375.           Program macros created from the Start Programs application
  1376.           provided with PM.  With this command you can import into PM
  1377.           Assistant all the program information you have stored in the
  1378.           Start Programs application.
  1379.  
  1380.           To build a Start Programs Group macro:
  1381.  
  1382.           1. Choose Macro Build                    Macro Build                    Macro Build.
  1383.  
  1384.           2. Choose Start Programs Group                    Start Programs Group                    Start Programs Group.
  1385.                The Select Group dialog box appears.
  1386.  
  1387.           2. Select the group you want from the list box.
  1388.  
  1389.           3. Click the OK                       OK                       OK button.
  1390.                The body of the Group macro is filled with Start
  1391.                Program macros.
  1392.  
  1393.           You can view and change the macro settings of macros created with
  1394.           the Macro Build              Macro Build              Macro Build commands just like any other macro.
  1395.  
  1396.  
  1397.           24   PM Assistant User's Guide
  1398.  
  1399.  
  1400.           Macro Execute Command          Macro Execute Command          Macro Execute Command
  1401.  
  1402.           Of the several ways to execute macros (see Executing Macros on
  1403.           page 10), the Macro Execute command gives you the most control.
  1404.           You can execute macros repeatedly, in random order, or with
  1405.           keyboard input blocked to prevent stray input.
  1406.  
  1407.           To execute a macro with the Macro Execute                                      Macro Execute                                      Macro Execute command:
  1408.  
  1409.           1. Select the macro to execute.
  1410.  
  1411.           2. Choose Macro Execute                    Macro Execute                    Macro Execute.
  1412.                The Macro Execute dialog box appears.
  1413.  
  1414.           3. Select the options you wish to use:
  1415.              *             *             * Execute once               Execute once               Execute once -                              Execute the macro once.
  1416.              *             *             * Execute ... times               Execute ... times               Execute ... times -                                   Executes the macro the specified
  1417.                number of times.
  1418.              *             *             * Execute indefinitely               Execute indefinitely               Execute indefinitely -                                      Executes the macro repeatedly
  1419.                until stopped by typing CTRL+C.
  1420.              *             *             * Execute Compound macro in random order               Execute Compound macro in random order               Execute Compound macro in random order -                                                        Executes the
  1421.                macros in the body of the selected CO macro in random
  1422.                order.  This is useful for PM application tests
  1423.                designed to `                                                       `                             stress                                   ''                                     an application by repeating
  1424.                input randomly.
  1425.              *             *             * Block all input during execution               Block all input during execution               Block all input during execution                                                  - Blocks mouse and
  1426.                keyboard input while executing the macro.  This is
  1427.                useful when the macro is part of a demonstration to be
  1428.                run unattended.
  1429.  
  1430.           4. Click the Execute                       Execute                       Execute button to execute the macro.
  1431.  
  1432.           HINT:
  1433.           If you always want to execute macro `XX' using options available
  1434.           with the Macro Execute                   Macro Execute                   Macro Execute command, you can create a Mouse & Keyboard
  1435.           Input macro which invokes the Macro Execute                                        Macro Execute                                        Macro Execute command to execute
  1436.           macro `XX'.  This way you can effectively execute macro `XX' by
  1437.           simply double-clicking on the Mouse & Keyboard input macro.
  1438.  
  1439.  
  1440.           Disabling Macros          Disabling Macros          Disabling Macros
  1441.  
  1442.           With the Macro Disable                   Macro Disable                   Macro Disable and Macro Disable All                                     Macro Disable All                                     Macro Disable All commands you can
  1443.           temporarily disable the hot-keys of macros so that you may enter
  1444.           those keystrokes into a PM application.  You can still execute a
  1445.           macro whose hot-keys are disabled by double-clicking on it or
  1446.           with the Macro Execute                   Macro Execute                   Macro Execute command.
  1447.  
  1448.           To disable the hot-key of a macro:
  1449.  
  1450.           1. Select the macro to disable.
  1451.  
  1452.  
  1453.                                                     Chapter 2:  Macros   25
  1454.  
  1455.  
  1456.           2. Choose Macro Disable                    Macro Disable                    Macro Disable.
  1457.                The display of the hot-key of the selected macro
  1458.                changes from red to blue indicating it is disabled.  A
  1459.                check mark appears on the Macro Disable                                         Macro Disable                                         Macro Disable menu item.
  1460.  
  1461.  
  1462.           To re-enable the hot-key of a macros:
  1463.  
  1464.           1. Select the macro to re-enable.
  1465.  
  1466.           2. Choose Macro Disable                    Macro Disable                    Macro Disable again.
  1467.                The display of the hot-key of the selected macro
  1468.                changes from blue to red indicating it is enabled.  The
  1469.                check mark disappears from the Macro Disable                                              Macro Disable                                              Macro Disable menu item.
  1470.  
  1471.           To temporarily disable the hot-keys of all macros:
  1472.  
  1473.           >          >          >  Choose Macro Disable All                    Macro Disable All                    Macro Disable All.
  1474.                The display of the hot-keys of all macros changes from
  1475.                red to blue indicating they are disabled.  A check mark
  1476.                appears on the Macro Disable All                              Macro Disable All                              Macro Disable All menu item.
  1477.  
  1478.  
  1479.           To re-enable the hot-keys of all macros:
  1480.  
  1481.           >          >          >  Choose Macro Disable All                    Macro Disable All                    Macro Disable All again.
  1482.                The display of the hot-keys of all macros change from
  1483.                blue back to red indicating they are enabled.  The
  1484.                check mark disappears from the Macro Disable All                                              Macro Disable All                                              Macro Disable All menu
  1485.                item.
  1486.  
  1487.           Macro Options          Macro Options          Macro Options
  1488.  
  1489.           Through the Macro Options                      Macro Options                      Macro Options command you can customize many elements
  1490.           of PM Assistant's display and behavior.
  1491.  
  1492.           To set the macro options:
  1493.  
  1494.           1. Choose Macro Options                    Macro Options                    Macro Options.
  1495.                The Macro Options dialog box appears.
  1496.  
  1497.           2. Select the options you wish to enable:
  1498.              *             *             * Display column widths               Display column widths               Display column widths                                       - Enter the widths of the hot-key
  1499.                and macro name columns in PM Assistant's display,
  1500.                measured in characters.
  1501.              *             *             * Keystroke treatment while entering hot-keys               Keystroke treatment while entering hot-keys               Keystroke treatment while entering hot-keys                                                             - Normally
  1502.                TAB, SHIFT+TAB and BACKSPACE keys are treated specially
  1503.                and cannot be entered as hot-keys (or as keystrokes in
  1504.                a KI macro).  Selecting these options allow you to
  1505.                enter those keys as part of hot-keys (or keystrokes in
  1506.                a KI macro).
  1507.  
  1508.  
  1509.           26   PM Assistant User's Guide
  1510.  
  1511.  
  1512.              *             *             * Minimize PM Assistant while pointing to a window               Minimize PM Assistant while pointing to a window               Minimize PM Assistant while pointing to a window                                                                  -
  1513.                Normally PM Assistant minimizes itself when performing
  1514.                the Point operation when creating Position Window or
  1515.                Keyboard Input macros.  This is done to unclutter the
  1516.                screen.  You can prevent this by clearing this option.
  1517.              *             *             * Minimize PM Assistant while recording MK macro               Minimize PM Assistant while recording MK macro               Minimize PM Assistant while recording MK macro                                                                -
  1518.                Normally PM Assistant minimizes itself when recording a
  1519.                Mouse & Keyboard Input macro.  This is done to
  1520.                unclutter the screen.  You can prevent this by clearing
  1521.                this option.
  1522.              *             *             * Restrict MK recording resolution to               Restrict MK recording resolution to               Restrict MK recording resolution to                                                     - Prevents the
  1523.                mouse from moving outside the specified area.
  1524.                Restricting the recording resolution of Mouse &
  1525.                Keyboard Input macros can improve the portability of
  1526.                such macros to systems with lower screen resolutions.
  1527.                For a discussion about Mouse & Keyboard Input macro
  1528.                portability, See Hints on page 17.  640 x 480 is
  1529.                standard VGA resolution.  800 x 600 is super VGA
  1530.                resolution.
  1531.              *             *             * MK Recording dialog box hot-key               MK Recording dialog box hot-key               MK Recording dialog box hot-key                                                 - Sets the hot-key for
  1532.                the Recording `macroname' dialog box which appears when
  1533.                recording a Mouse & Keyboard Input macro.  When typed,
  1534.                this hot-key brings the Recording `macroname' dialog
  1535.                box to the foreground so the macro can easily be paused
  1536.                or resumed.  For information about recording Mouse &
  1537.                Keyboard Input macros, see Mouse & Keyboard Input Macro
  1538.                on page 14.
  1539.  
  1540.           3. Click the Save                       Save                       Save button to save these settings for future
  1541.              invocations of PM Assistant.
  1542.  
  1543.              or
  1544.  
  1545.           4. Click the OK                       OK                       OK button to accept these settings for just the
  1546.              current invocation of PM Assistant.
  1547.  
  1548.  
  1549.                                     Chapter 3:  Editing Macro Listings   27
  1550.  
  1551.  
  1552.  
  1553.  
  1554.           3          3          3    Editing Macro Listings               Editing Macro Listings               Editing Macro Listings
  1555.  
  1556.  
  1557.           Using the Edit                    Edit                    Edit commands, you can:
  1558.  
  1559.            -           -           -Rearrange the order in which macros are displayed in the
  1560.             macro list.
  1561.            -           -           -Duplicate macros.
  1562.            -           -           -Move macros in and out of Group and Compound macros.
  1563.            -           -           -Move entire Group and Compound macros.
  1564.            -           -           -Move or copy macros from one macro file to another.
  1565.  
  1566.           The Edit              Edit              Edit commands make use of a temporary macro storage area
  1567.           called the Edit clipboard.  Macros are cut or copied to, and
  1568.           pasted from, the Edit clipboard.  The name of the macro currently
  1569.           on the Edit clipboard is displayed at the bottom of the Edit                                                                  Edit                                                                  Edit
  1570.           menu.  The macro on the Edit clipboard cannot be executed and
  1571.           will not be found with the View Find                                     View Find                                     View Find command.  PM Assistant's
  1572.           Edit clipboard is not the same as the Presentation Manager
  1573.           clipboard; you cannot transfer macros to other PM applications.
  1574.  
  1575.           When an Edit                  Edit                  Edit command is applied to a Group or Compound macro, it
  1576.           effects both the macro and the macros it contains.  Thus you can
  1577.           move or copy many macros at once by collecting them in a Group or
  1578.           Compound macro.
  1579.  
  1580.  
  1581.           Moving Macros          Moving Macros          Moving Macros
  1582.  
  1583.           1. Select the macro you wish to move.
  1584.  
  1585.           2. Choose Edit Cut.                    Edit Cut.                    Edit Cut.
  1586.                The selected macro is removed from the macro list
  1587.                display and placed on the Edit clipboard.
  1588.  
  1589.           3. Select the macro in the list after which you want to paste
  1590.              the cut macro.
  1591.  
  1592.           4. Choose Edit Paste                    Edit Paste                    Edit Paste.
  1593.                The cut macro appears in the display after the selected
  1594.                macro.
  1595.  
  1596.  
  1597.           Copying Macros          Copying Macros          Copying Macros
  1598.  
  1599.           1. Select the macro you wish to copy.
  1600.  
  1601.  
  1602.           28   PM Assistant User's Guide
  1603.  
  1604.  
  1605.           2. Choose Edit Copy.                    Edit Copy.                    Edit Copy.
  1606.                A copy of the selected macro is placed on the Edit
  1607.                clipboard. The name of the duplicate macro will have a
  1608.                number 2 appended to it.  Since macros should generally
  1609.                have unique names, PM Assistant `                                                                                               `                                                 increments                                                           ''                                                             the name
  1610.                when a macro is copied.
  1611.  
  1612.           3. Select the macro on the list after which you want to paste
  1613.              the copied macro.
  1614.  
  1615.           4. Choose Edit Paste                    Edit Paste                    Edit Paste.
  1616.                The copy of the macro appears in the display after the
  1617.                selected macro.
  1618.  
  1619.           Deleting Macros          Deleting Macros          Deleting Macros
  1620.  
  1621.           1. Select the macro you want to delete.
  1622.  
  1623.           2. Choose Edit Delete                    Edit Delete                    Edit Delete.
  1624.  
  1625.           You can delete all macros at once with the File New                                                     File New                                                     File New command.
  1626.  
  1627.           To undo the last editing command:
  1628.  
  1629.           >          >          >  Choose Edit Undo                    Edit Undo                    Edit Undo.
  1630.  
  1631.           With this command you can recover a deleted macro.
  1632.  
  1633.  
  1634.                                             Chapter 4:  Viewing Macros   29
  1635.  
  1636.  
  1637.  
  1638.  
  1639.           4          4          4    Viewing Macros               Viewing Macros               Viewing Macros
  1640.  
  1641.  
  1642.           With the View                   View                   View commands, you can change the way macros are
  1643.           displayed and search for a macro by name, comment or hot-key.
  1644.           You can change the widths of the hot-key and name columns in the
  1645.           macro display with the Macro Options                                 Macro Options                                 Macro Options command, see Macro Options
  1646.           on page 25.
  1647.  
  1648.  
  1649.           Expanding and Collapsing Macros          Expanding and Collapsing Macros          Expanding and Collapsing Macros
  1650.  
  1651.           The display of the body of Compound and Group macros can be
  1652.           expanded and collapsed.  Collapsing the contents unclutters the
  1653.           display and lets you concentrate on the surrounding macros.
  1654.           There are two ways to expand and collapse the display of Compound
  1655.           and Group macros:  the View Expand                                 View Expand                                 View Expand command and the
  1656.           Expand/Collapse button.
  1657.  
  1658.  
  1659.           To expand a macro with the View Expand                                     View Expand                                     View Expand command:
  1660.  
  1661.           1. Select the macro to be expanded.
  1662.  
  1663.           2. Choose View Expand                    View Expand                    View Expand.
  1664.                The selected macro will expand to show its contents.
  1665.  
  1666.           To collapse a macro with the View Expand                                       View Expand                                       View Expand command:
  1667.  
  1668.           1. Select the macro you wish to collapse.
  1669.  
  1670.           2. Choose View Expand                    View Expand                    View Expand.
  1671.                The selected macro will collapse.
  1672.  
  1673.           To expand or collapse a macro with the Expand/Collapse button:
  1674.  
  1675.           >          >          >  Click on the (+) or (                                   -) symbol in front of the macro name in
  1676.              the macro display.  The (+) symbol is displayed if the macro
  1677.              is collapsed, the (                                 -) symbol is displayed if the macro is
  1678.              expanded.
  1679.  
  1680.           To temporarily expand all macros:
  1681.  
  1682.           >          >          >  Choose View Expand All                    View Expand All                    View Expand All.
  1683.                All of the Group and Compound macros will expand to
  1684.                show their contents.  A checkmark appears next to the
  1685.                View               View               View Expand All                    Expand All                    Expand All command.
  1686.  
  1687.           Expanding and collapsing individual macros with the View Expand                                                              View Expand                                                              View Expand
  1688.           command or the Expand/Collapse buttons has no effect while the
  1689.           View Expand All          View Expand All          View Expand All command is in effect.
  1690.  
  1691.  
  1692.           30   PM Assistant User's Guide
  1693.  
  1694.  
  1695.           To return macros to their prior state after viewing them with
  1696.           View Expand All          View Expand All          View Expand All:
  1697.  
  1698.           >          >          >  Choose View Expand All                    View Expand All                    View Expand All.
  1699.                The macros will return to their prior expanded or
  1700.                collapsed state.  The checkmark next to the View Expand                                                           View Expand                                                           View Expand
  1701.                All               All               All command disappears.
  1702.  
  1703.  
  1704.           Finding Macros          Finding Macros          Finding Macros
  1705.  
  1706.           To search for a macro by name, comment, or hot-key:
  1707.  
  1708.           1. Select the first macro in the macro list you want to search.
  1709.                Find always starts from the currently selected macro.
  1710.                You can quickly move to the beginning of the macro list
  1711.                by pressing the HOME key.
  1712.  
  1713.           2. Choose View Find Macro                    View Find Macro                    View Find Macro.
  1714.                The Find Macro dialog box appears.
  1715.  
  1716.           3. Enter the search string in the Search string                                            Search string                                            Search string text box.
  1717.                The string can be a substring of any of the three macro
  1718.                attributes.  In the case of hot-key combinations, type
  1719.                the strings that appear as you entered the hot-key,
  1720.                that is, spell out Ctrl+y to search for the CTRL+Y
  1721.                combination.
  1722.  
  1723.           4. Select any of the Name                               Name                               Name, Comment                                     Comment                                     Comment, or Hot-key                                                 Hot-key                                                 Hot-key check boxes.
  1724.                You can search for a macro by name, comment, and hot-
  1725.                key simultaneously.
  1726.  
  1727.           5. Select Case sensitive                    Case sensitive                    Case sensitive or Case insensitive                                      Case insensitive                                      Case insensitive.
  1728.                Case sensitive               Case sensitive               Case sensitive will find only those strings that match
  1729.                upper-lower case; Case-insensitive                                 Case-insensitive                                 Case-insensitive will find strings
  1730.                regardless of capitalization.
  1731.  
  1732.           6. Click the Search                       Search                       Search button to begin the search.
  1733.                The Find Macro dialog box disappears.  The PM Assistant
  1734.                display appears with the found macro selected.  If the
  1735.                found macro is within a collapsed Group or Compound
  1736.                macro, the Group or Compound macro will be expanded to
  1737.                show the found macro.  A message appears in the
  1738.                Status/Help line reporting the success or failure of
  1739.                the search.
  1740.  
  1741.  
  1742.           To search for the next matching macro using the same search
  1743.           criteria:
  1744.  
  1745.           >          >          >  Choose View Find Next                    View Find Next                    View Find Next.
  1746.                The PM Assistant display appears with the next macro
  1747.                matching the search criteria selected.
  1748.  
  1749.  
  1750.                                             Chapter 4:  Viewing Macros   31
  1751.  
  1752.  
  1753.           Suppressing the Status/Help Line          Suppressing the Status/Help Line          Suppressing the Status/Help Line
  1754.  
  1755.           The Status/Help line can be removed to provide more space to
  1756.           display macros.
  1757.  
  1758.           To suppress display of the Status/Help line:
  1759.  
  1760.           >          >          >  Choose View Status/Help Line                    View Status/Help Line                    View Status/Help Line.
  1761.                The checkmark next to the Status/Help Line                                         Status/Help Line                                         Status/Help Line menu item
  1762.                disappears.  The Status/Help line is removed.
  1763.  
  1764.  
  1765.           To restore display of the Status/Help line:
  1766.  
  1767.           >          >          >  Choose View Status/Help Line                    View Status/Help Line                    View Status/Help Line.
  1768.                A checkmark appears next to the Status/Help Line                                                Status/Help Line                                                Status/Help Line menu
  1769.                item.
  1770.                The Status/Help line appears in the PM Assistant
  1771.                display.
  1772.  
  1773.  
  1774.           Viewing Memory Statistics          Viewing Memory Statistics          Viewing Memory Statistics
  1775.  
  1776.           You can determine how much memory the macro list occupies with
  1777.           the View Memory Stats              View Memory Stats              View Memory Stats command.
  1778.  
  1779.           To display memory statistics in the Status/Help line:
  1780.  
  1781.           >          >          >  Choose View Memory Stats                    View Memory Stats                    View Memory Stats.
  1782.                The message:  `                                                           `                               Macro list in memory: <number> bytes,
  1783.                in a file: <number> bytes'                                                                                 '                                           appears in the Status/Help
  1784.                line.  The first number is the size of the macro list
  1785.                in main memory while loaded into PM Assistant.  The
  1786.                second number is the size of the macro list on disk
  1787.                when saved to a file.  These values include the macro
  1788.                on the Editing clipboard and the last macro deleted.
  1789.  
  1790.  
  1791.                                                Chapter 5:  Macro Files   33
  1792.  
  1793.  
  1794.  
  1795.  
  1796.           5          5          5    Macro Files               Macro Files               Macro Files
  1797.  
  1798.  
  1799.           A macro file contains a list of macros that are loaded
  1800.           simultaneously into PM Assistant and appear in the PM Assistant
  1801.           display together.  You can have several macro files containing
  1802.           different lists of macros, such as different lists for two users
  1803.           of the same workstation.  Macro files usually have the extension
  1804.           .pma.
  1805.  
  1806.           Opening Macro Files          Opening Macro Files          Opening Macro Files
  1807.  
  1808.           To open a macro file and load the macros into PM Assistant:
  1809.  
  1810.           1. Choose File Open                    File Open                    File Open.
  1811.                The Load Macros From File dialog box appears.
  1812.  
  1813.           2. Enter the name of the macro file you wish to open in the
  1814.              Filename             Filename             Filename box.
  1815.                You can type in the filename or select it using the
  1816.                Directories               Directories               Directories and Files                               Files                               Files list boxes.
  1817.  
  1818.           3. If you do not want to change the file,  check the File is                                                               File is                                                               File is
  1819.              read only             read only             read only option.
  1820.                This will prevent you from accidentally overwriting the
  1821.                file with the File Save                             File Save                             File Save command.
  1822.  
  1823.           4. Select either of the Replace                                  Replace                                  Replace or Insert                                             Insert                                             Insert options:
  1824.              *             *             * Replace current list of macros               Replace current list of macros               Replace current list of macros                                                - will replace the
  1825.                current list of macros with the contents of the new
  1826.                macro file.
  1827.              *             *             * Insert into current list of macros               Insert into current list of macros               Insert into current list of macros                                                    - will insert the
  1828.                contents of the file into the current macro list just
  1829.                after the selected macro.
  1830.  
  1831.           5. Click the Load                       Load                       Load button.
  1832.                The PM Assistant display returns with the contents of
  1833.                the opened macro file.
  1834.  
  1835.           You can also load a macro file when starting PM Assistant with a
  1836.           command line argument, see Starting and Exiting PM Assistant on
  1837.           page 1.
  1838.  
  1839.           NOTE:
  1840.           If you have modified the current macro list and choose a command
  1841.           that would discard the current list of macros (such as File New                                                                 File New                                                                 File New),
  1842.           PM Assistant will ask if you wish to save the current list of
  1843.           macros before performing the command.  Click the Yes                                                           Yes                                                           Yes button to
  1844.           save to the proposed filename.  Click the No                                                    No                                                    No button to continue
  1845.           without saving.  Click the Cancel                                     Cancel                                     Cancel button to cancel the command.
  1846.  
  1847.  
  1848.           34   PM Assistant User's Guide
  1849.  
  1850.  
  1851.           To find out if you've modified the current macro list, activate
  1852.           the File              File              File menu (press ALT F).  The Status/Help line will report
  1853.           whether the macro list has been modified.
  1854.  
  1855.  
  1856.           Merging Macro Files          Merging Macro Files          Merging Macro Files
  1857.  
  1858.           To merge a macro file with the current list of macros, choose
  1859.           File Open          File Open          File Open, select Insert into current list of macros                            Insert into current list of macros                            Insert into current list of macros, and load
  1860.           the desired file.  The macros will be inserted just after the
  1861.           currently selected macro.
  1862.  
  1863.  
  1864.           Saving Macro Files          Saving Macro Files          Saving Macro Files
  1865.  
  1866.           To save changes to the current macro file:
  1867.  
  1868.           1. Choose File                    File                    File.
  1869.                The File                   File                   File menu appears.  The name of the current macro
  1870.                file (if there is one) appears in the Save `filename'                                                     Save `filename'                                                     Save `filename'
  1871.                menu item.
  1872.  
  1873.           2. Choose Save `filename'                    Save `filename'                    Save `filename'.
  1874.                The current macro list is saved to the given file.
  1875.  
  1876.  
  1877.           To save the current macro list to a macro file of another name:
  1878.  
  1879.           1. Choose File                    File                    File.
  1880.                The File                   File                   File menu appears.  The name of the current macro
  1881.                file appears in the Save `filename'                                    Save `filename'                                    Save `filename' command.
  1882.  
  1883.           2. Choose Save As                    Save As                    Save As.
  1884.                The Save Macros To File dialog box appears.
  1885.  
  1886.           3. Enter the name of the file to save to in the Save macros to                                                          Save macros to                                                          Save macros to
  1887.              file             file             file text box.
  1888.  
  1889.           4. Click the Save                       Save                       Save button.
  1890.  
  1891.  
  1892.           New Macro Files          New Macro Files          New Macro Files
  1893.  
  1894.           To create a new empty macro file:
  1895.  
  1896.           >          >          >  Choose File New                    File New                    File New.
  1897.                PM Assistant discards the current macro list and
  1898.                displays
  1899.                                `               `                 No macros.'                           '                            
  1900.  
  1901.  
  1902.                                                Chapter 5:  Macro Files   35
  1903.  
  1904.  
  1905.           Printing Macro Lists          Printing Macro Lists          Printing Macro Lists
  1906.  
  1907.           You can print the text of a macro list to a file.  The hot-key,
  1908.           abbreviation of the macro type, macro name and comment of all
  1909.           macros in the current list of macros are printed.
  1910.  
  1911.  
  1912.           To print the current list of macros:
  1913.  
  1914.           1. Choose File Print                    File Print                    File Print.
  1915.                The Print Macro List To File dialog box appears.
  1916.  
  1917.           2. Enter the name of the file to print to in the Print macros to                                                           Print macros to                                                           Print macros to
  1918.              file             file             file box.
  1919.  
  1920.           3. Click the Print                       Print                       Print button to print to the named file.
  1921.  
  1922.  
  1923.                                           Chapter 6:  Control Features   37
  1924.  
  1925.  
  1926.  
  1927.  
  1928.           6          6          6    Control Features               Control Features               Control Features
  1929.  
  1930.  
  1931.           As well as creating and executing macros, PM Assistant has four
  1932.           control features to further customize your computer use: Process
  1933.           Priorities, Password Protection, Screen Saver, and Speed Button.
  1934.           The settings for these features can be preserved across
  1935.           invocations of PM Assistant.
  1936.  
  1937.  
  1938.           Process Priorities          Process Priorities          Process Priorities
  1939.  
  1940.           With the Process Priorities command, you can set the OS/2 process
  1941.           prioritization of programs started with PM Assistant Start
  1942.           Program macros.
  1943.  
  1944.           OS/2 is a multitasking operating system, so it must distribute
  1945.           the computer's resources between the various processes running on
  1946.           the system.  OS/2  determines priority between processes based on
  1947.           two characteristics assigned to each process: the priority class
  1948.           and the priority number.
  1949.  
  1950.           There are three priority classes which may be assigned to a
  1951.           process:
  1952.  
  1953.            -           -           -Idle-time                        - Processes in this class receive spare CPU time
  1954.             only when processes of the other two classes are idle.  This
  1955.             is the lowest class of process priority.
  1956.  
  1957.            -           -           -Normal                     - Most processes fall into this category.  They use
  1958.             CPU time available after the running of Time Critical
  1959.             processes.
  1960.            -           -           -Time Critical                            - These processes absolutely must run quickly
  1961.             for the correct functioning of the computer.  Processes in
  1962.             this class always get as much time as they require, ahead of
  1963.             those in the normal and idle-time classes.  This class is
  1964.             generally reserved for special processes - such as a low-
  1965.             level disk system that must quickly read information out of
  1966.             the disk buffers.
  1967.  
  1968.           Processes are also assigned priority numbers between 0 and 31.
  1969.           The process priority number is a measure of how much time a given
  1970.           process receives relative to other processes in its same class.
  1971.           If several processes in the same priority class are running at
  1972.           once, a process with a priority of 31 will run very fast, while a
  1973.           process of value 0 will run slowly.
  1974.  
  1975.           To set Process Priorities:
  1976.  
  1977.           1. Start with a PM Assistant Start Program macro the program
  1978.              whose process priority you wish to change.
  1979.  
  1980.  
  1981.           38   PM Assistant User's Guide
  1982.  
  1983.  
  1984.           2. Choose Control Process Priority                    Control Process Priority                    Control Process Priority.
  1985.                The Process Priority Control dialog box appears showing
  1986.                a list of programs started with PM Assistant.
  1987.  
  1988.           3. Choose the process from the list box.
  1989.                The Current process priority                   Current process priority                   Current process priority box shows the process'
  1990.                priority class and level.
  1991.  
  1992.           4. Select the priority class for your process from the Normal                                                                 Normal                                                                 Normal,
  1993.              Idle-time             Idle-time             Idle-time and Time-critical                           Time-critical                           Time-critical check boxes.
  1994.                Before setting a process as Time-critical                                           Time-critical                                           Time-critical, please read
  1995.                the note following this section.
  1996.  
  1997.           5. Set the priority level at a value between 0                                                       0                                                       0 and 31                                                             31                                                             31 with the
  1998.              scroll-bar.
  1999.  
  2000.           6. Click the Set priority                       Set priority                       Set priority button to set the priority.
  2001.  
  2002.           7. Click the Done                       Done                       Done button to dismiss the dialog box.
  2003.  
  2004.  
  2005.           NOTE: Before setting process priorities as Time-critical                                                     Time-critical                                                     Time-critical:
  2006.  
  2007.           Assigning a process priority class of Time-critical                                                Time-critical                                                Time-critical to a user-
  2008.           level process can disrupt or even stop the correct functioning of
  2009.           OS/2 by preempting time needed for more critical processes.  If
  2010.           this happens, reset the process priority back to Normal                                                           Normal                                                           Normal or Idle-                                                                     Idle-                                                                     Idle-
  2011.           time          time          time.  Also, some programs which are multithreaded control the
  2012.           process priorities of their threads of execution themselves for
  2013.           better performance.   These programs are typically special
  2014.           hardware-managing programs such as print spoolers, or keyboard
  2015.           and mouse monitoring programs (such as PM Assistant!).  You may
  2016.           experience system degradation such as poor keystroke
  2017.           responsiveness after setting such a program's process priority.
  2018.  
  2019.           Also note that if you click the mouse on a very busy process (or
  2020.           one with an idle-time class), you must wait for it to process
  2021.           that mouse click before you can interact with a different
  2022.           process.  (This is because the mouse and keyboard input to PM
  2023.           applications must be strictly serialized for Presentation Manager
  2024.           to work properly).
  2025.  
  2026.  
  2027.           Password Protection          Password Protection          Password Protection
  2028.  
  2029.           When the Password Protection control feature is invoked, PM
  2030.           Assistant will block keyboard and mouse input until the correct
  2031.           password is entered.  Password Protection can be set to be
  2032.           automatically invoked after a certain period of keyboard and
  2033.           mouse inactivity.  Since Password Protection is a software rather
  2034.           than a hardware security device, it can be overcome by someone
  2035.           determined to do so.  You will probably know when somebody has
  2036.           forced access, however, since the only way to break in is by
  2037.           rebooting your computer.
  2038.  
  2039.  
  2040.                                           Chapter 6:  Control Features   39
  2041.  
  2042.  
  2043.           To set Password Protection options:
  2044.  
  2045.           1. Choose Control Password                    Control Password                    Control Password.
  2046.                The Password Protection dialog box appears.
  2047.  
  2048.           2. Enter in the Time delay                          Time delay                          Time delay fields the hours, minutes, and
  2049.              seconds you want the keyboard and mouse to be idle before
  2050.              requiring a password entry.
  2051.  
  2052.           3. Select the Enabled                        Enabled                        Enabled button to enable automatic invocation of
  2053.              Password Protection after the time set in Time delay                                                       Time delay                                                       Time delay.
  2054.                A checkmark will appear next to the Password                                                   Password                                                   Password menu item
  2055.                in the Control                      Control                      Control menu to indicate automatic invocation is
  2056.                enabled.
  2057.  
  2058.           4. Click the Password                       Password                       Password button.
  2059.                The Password Entry dialog box appears.
  2060.  
  2061.           5. Enter your password.
  2062.                Password Protection accepts passwords as case-
  2063.                sensitive.  The Password Entry dialog box reappears to
  2064.                verify your password.
  2065.  
  2066.           6. Enter your password again to verify it.
  2067.                If you fail to reenter your password correctly, a
  2068.                warning box appears and the password change is
  2069.                canceled.
  2070.  
  2071.           7. Click the Save                       Save                       Save button to save these settings for future
  2072.              invocations of PM Assistant.
  2073.  
  2074.              or
  2075.  
  2076.           8. Click the OK                       OK                       OK button to accept these settings for just the
  2077.              current invocation of PM Assistant.
  2078.  
  2079.  
  2080.           To disable automatic invocation of Password Protection:
  2081.  
  2082.           1. Choose Control Password                    Control Password                    Control Password.
  2083.                The Password Protection dialog box appears.
  2084.  
  2085.           2. Select the Disabled                        Disabled                        Disabled option.
  2086.                The checkmark disappears from the Password                                                 Password                                                 Password menu item in
  2087.                the Control                   Control                   Control menu.
  2088.  
  2089.           If you forget your password:
  2090.  
  2091.           1. Reboot your machine by pressing CTRL+ALT+DEL.
  2092.  
  2093.           2. Reset Password Protection as described above.
  2094.  
  2095.  
  2096.           40   PM Assistant User's Guide
  2097.  
  2098.  
  2099.           Screen Saver          Screen Saver          Screen Saver
  2100.  
  2101.           Leaving the same image on your screen for an extended period of
  2102.           time can                     `                   `                     burn'                         '                           that image into the screen.  The Screen Saver
  2103.           prevents the screen from being damaged by blanking the screen.
  2104.           With Screen Saver, you do not need to turn your monitor off when
  2105.           you leave your workstation.  After a period of mouse and keyboard
  2106.           inactivity, the screen saver is automatically invoked -                                                                  the
  2107.           screen goes black and a message of your choice moves around it in
  2108.           different colors.
  2109.  
  2110.  
  2111.           When you wish to use your computer again, move the mouse or press
  2112.           any key to restore the display.
  2113.  
  2114.           To set the Screen Saver:
  2115.  
  2116.           1. Choose Control Screen Saver                    Control Screen Saver                    Control Screen Saver.
  2117.                The Screen Saver dialog box comes up.
  2118.  
  2119.           2. Enter in the Time delay                          Time delay                          Time delay boxes the hours, minutes, and seconds
  2120.              you want the keyboard and mouse to remain idle before
  2121.              automatically invoking the screen saver.
  2122.  
  2123.           3. Enter in the Text to display                          Text to display                          Text to display box the string you want your
  2124.              screen to display (optional).
  2125.  
  2126.           4. Select the Enabled                        Enabled                        Enabled button to enable the automatic invocation
  2127.              of the Screen Saver.
  2128.                A checkmark will appear next to the Screen Saver                                                   Screen Saver                                                   Screen Saver menu
  2129.                item in the Control                           Control                           Control menu.
  2130.  
  2131.           5. Click the Save                       Save                       Save button to save these settings for future
  2132.              invocations of PM Assistant.
  2133.  
  2134.              or
  2135.  
  2136.           6. Click the OK                       OK                       OK button to accept these settings for just the
  2137.              current invocation of PM Assistant.
  2138.  
  2139.  
  2140.           To disable automatic invocation of the Screen Saver:
  2141.  
  2142.           1. Choose Control Screen Saver                    Control Screen Saver                    Control Screen Saver.
  2143.                The Screen Saver dialog box appears.
  2144.  
  2145.           2. Select the Disabled                        Disabled                        Disabled option in the Automatic Invocation
  2146.              section.
  2147.                The checkmark disappears from the Saver                                                 Saver                                                 Saver menu item in
  2148.                the Control                   Control                   Control menu.
  2149.  
  2150.  
  2151.                                           Chapter 6:  Control Features   41
  2152.  
  2153.  
  2154.           NOTE:
  2155.           PM Assistant does not monitor keyboard input in full-screen
  2156.           sessions not started by PM Assistant.  Therefore, automatic
  2157.           invocation of Password Protection and Screen Saver will never
  2158.           occur when such a full-screen session is in the foreground.
  2159.  
  2160.  
  2161.           Invoking Password Protection, Screen Saver, or Both          Invoking Password Protection, Screen Saver, or Both          Invoking Password Protection, Screen Saver, or Both
  2162.  
  2163.           In addition to, or instead of, setting Password Protection or
  2164.           Screen Saver to be invoked automatically after the keyboard has
  2165.           been idle for a period, you can immediately invoke one or both
  2166.           through the Control                      Control                      Control menu.
  2167.  
  2168.  
  2169.           To immediately invoke Password Protection:
  2170.  
  2171.           1. Choose Control Invoke                    Control Invoke                    Control Invoke.
  2172.  
  2173.           2. Choose Password Protection                    Password Protection                    Password Protection.
  2174.                The Password Entry dialog box appears.
  2175.  
  2176.           To immediately invoke the Screen Saver:
  2177.  
  2178.           1. Choose Control Invoke                    Control Invoke                    Control Invoke.
  2179.  
  2180.           2. Choose Screen Saver                    Screen Saver                    Screen Saver.
  2181.                The screen goes black, and your phrase appears.
  2182.  
  2183.  
  2184.           To immediately invoke both Password Protection and the Screen
  2185.           Saver:
  2186.  
  2187.           1. Choose Control Invoke                    Control Invoke                    Control Invoke.
  2188.  
  2189.           2. Choose Both                    Both                    Both.
  2190.                The screen goes black.  If a keystroke is entered, the
  2191.                Password Entry dialog box appears.
  2192.  
  2193.  
  2194.           Speed Button          Speed Button          Speed Button
  2195.  
  2196.           The Speed Button feature makes the right mouse button behave like
  2197.           the ENTER key when a dialog box is in the foreground.  This way
  2198.           you can quickly click the default button of the dialog box
  2199.           without moving the mouse pointer over the button and without
  2200.           taking your hands off the mouse to press the ENTER key.
  2201.  
  2202.           The default button of a dialog box has a thicker border.  By
  2203.           convention, the default button usually dismisses the dialog box,
  2204.           accepting the new settings.  Often the OK                                                 OK                                                 OK or Done                                                       Done                                                       Done button is the
  2205.           default button.  By making it easier to dismiss a dialog box,
  2206.           Speed Button can speed dialog box interaction significantly.
  2207.  
  2208.  
  2209.           42   PM Assistant User's Guide
  2210.  
  2211.  
  2212.           To enable the Speed Button feature:
  2213.  
  2214.           >          >          >  Choose Control Speed Button                    Control Speed Button                    Control Speed Button.
  2215.                A check mark appears next to the Speed Button                                                Speed Button                                                Speed Button menu item
  2216.                in the Control                      Control                      Control menu indicating Speed Button is enabled.
  2217.  
  2218.           To disable the Speed Button feature:
  2219.  
  2220.           >          >          >  Choose Control Speed Button                    Control Speed Button                    Control Speed Button.
  2221.                The check mark next to the Speed Button                                          Speed Button                                          Speed Button menu item in
  2222.                the Control                   Control                   Control menu disappears, indicating Speed Button is
  2223.                disabled.
  2224.  
  2225.           The current setting of the Speed Button feature (enabled or
  2226.           disabled) is preserved when you save the Macro Options                                                   Macro Options                                                   Macro Options settings
  2227.           with the Save                   Save                   Save button.  This way you can save the setting across
  2228.           invocations of PM Assistant.  See Macro Options on page 25.
  2229.  
  2230.  
  2231.                                      Chapter 7:  Demonstration Utility   43
  2232.  
  2233.  
  2234.  
  2235.  
  2236.           7          7          7    Demonstration Utility               Demonstration Utility               Demonstration Utility
  2237.  
  2238.  
  2239.           This utility allows you to design automated demonstrations and
  2240.           tutorials for your software or business procedures.  A
  2241.           demonstration is made up of PM Assistant macros being run in
  2242.           concert with textual explanations of what is being demonstrated.
  2243.           The PM Assistant demonstration (run with demo.cmd) is created
  2244.           this way.
  2245.  
  2246.           A demonstration consists of two files:
  2247.  
  2248.           1. A PM Assistant macros file containing macros to be executed
  2249.              to perform the demonstration.
  2250.  
  2251.           2. An ASCII text `                            `                             demo file'                                       '                                         containing the text to display
  2252.              during the demonstration and directives controlling text
  2253.              formatting and the execution of PM Assistant macros.  Demo
  2254.              files usually have the extension .pmd.
  2255.  
  2256.           The macros are created with PM Assistant and referred to by name
  2257.           in the demo file.
  2258.  
  2259.           To execute the demonstration utility:
  2260.  
  2261.           >          >          >  Type pmademo demofile[.pmd] at the OS/2 prompt.
  2262.  
  2263.           The rest of this chapter describes the demo file.  See the PM
  2264.           Assistant demonstration files pmademo.pma (macro file) and
  2265.           pmademo.pmd (demo file) for examples.
  2266.  
  2267.  
  2268.           Demo Files          Demo Files          Demo Files
  2269.  
  2270.           A demo file is made of up ASCII text intermingled with directives
  2271.           which look like: {directive:value,directive2:value2...}.  One or
  2272.           more directives can be combined within the {}.  Not all
  2273.           directives take a value.  Directives are case insensitive.  A
  2274.           brief demo file might look like:
  2275.  
  2276.  
  2277.           44   PM Assistant User's Guide
  2278.  
  2279.  
  2280.           ____ _________          File contents:          ____ _________          File contents:          ____ _________          File contents:                ____________                                        Explanation:                                        ____________                                        Explanation:                                        ____________                                        Explanation:
  2281.  
  2282.           {mfile:ademo.pma}             Gives the name of the macro file.
  2283.           {lmgn:20,rmgn:20,font:helv,pt:14}
  2284.                                         Text formatting directives.
  2285.           Loading data...               Text to display during file read.
  2286.           {macro:posdemo}               PW macro to position the demo
  2287.                                         window.
  2288.           {page}                        Teparate next page.
  2289.           {lmgn:20,rmgn:20,font:helv,pt:14}
  2290.                                         Text formatting directives for new
  2291.                                         page.
  2292.           This is the beginning of a demo.
  2293.                                         Text to display.
  2294.           {macro:firstmacro}            A macro to execute after this page.
  2295.  
  2296.           The user steps through the pages by clicking the Continue                                                           Continue                                                           Continue button
  2297.           at the bottom of the demonstration display.  The macros specified
  2298.           by {macro:name} are executed after the user clicks Continue                                                             Continue                                                             Continue.  The
  2299.           next page is not displayed until that macro finishes.  After a
  2300.           macro file specified by {mfile:filename} is loaded, the next page
  2301.           is automatically advanced.  Thus the Loading data... text in the
  2302.           example is displayed while the macro file ademo.pma is being
  2303.           loaded.  Text is word wrapped automatically to fill the
  2304.           demonstration display window.  Newlines in the text file are
  2305.           treated as spaces.  Explicit newlines are entered with the
  2306.           newline directive:  {n}.  The escape char '\' is used to prevent
  2307.           the '{' character from introducing a directive, for example:
  2308.  
  2309.                some text \{after curly
  2310.  
  2311.           is displayed as:
  2312.  
  2313.                some text {after curly
  2314.  
  2315.           Similarly, the escape character '\' escapes a newline - causing
  2316.           it to be discarded rather than turned into a space.  It also
  2317.           escapes itself:
  2318.  
  2319.                long\\text\
  2320.                nospace
  2321.  
  2322.           is displayed as:
  2323.  
  2324.                long\textnospace
  2325.  
  2326.  
  2327.           Control Directives          Control Directives          Control Directives
  2328.  
  2329.           comment:text    A comment in the demo file.  Is not displayed
  2330.                           when the demonstration is run.
  2331.           mfile:filename  Macro file to load if the demo is run on a
  2332.                           computer with a mouse installed.
  2333.  
  2334.  
  2335.                                      Chapter 7:  Demonstration Utility   45
  2336.  
  2337.  
  2338.           kfile:filename  Macro file to load if the demo is run on a
  2339.                           computer without a mouse installed.
  2340.                Any kfile directives should precede mfile directives.
  2341.                This way, if the demo utility encounters an mfile
  2342.                directive without having seen a kfile directive on a
  2343.                computer without a mouse installed, it displays a
  2344.                `                               `                 this demo requires a mouse                                           ''                                             message and exits.
  2345.  
  2346.           macro:macroname Macro to execute after the current page (after
  2347.                           user clicks the Continue                                          Continue                                          Continue button).
  2348.           smacro:macronameMacro to execute prior to the current page (as
  2349.                           soon as the current page is displayed).
  2350.           page            Separates pages (screens) of the demo.
  2351.           title:a title   The title of the demo to display on the title
  2352.                           bar of the demo window.
  2353.  
  2354.  
  2355.           Text Formatting Directives          Text Formatting Directives          Text Formatting Directives
  2356.  
  2357.           By default, text is displayed in the system font with no margins
  2358.           and word wrapping turned on.
  2359.  
  2360.           n                   A newline.
  2361.           font:fontname       Font to use to display subsequent text.
  2362.                               Recognized fonts are: TmsRmn, helv, courier,
  2363.                               sys.
  2364.           style:stylename     Typeface style to use to display subsequent
  2365.                               text. Recognized styles are: normal, italic,
  2366.                               bold.
  2367.           pt:number           Point size.  Recognized sizes are: 8, 10, 12,
  2368.                               14, 18, 24.  Not all fonts are available in
  2369.                               all point sizes.
  2370.           fclr:color          Foreground color.  Colors are: white, black,
  2371.                               palegrey, blue, red, pink, green, cyan,
  2372.                               yellow, darkgrey, darkblue, darkred,
  2373.                               darkpink, darkgreen, darkcyan.  You can also
  2374.                               use the following special colors which
  2375.                               correspond to the settings of the
  2376.                               Presentation Manager Control Panel:
  2377.                                 fstd    foreground standard color.
  2378.                                 bstd    background standard color.
  2379.                                 fhelp   foreground help color.
  2380.                                 bhelp   background help color.
  2381.                                 hhelp   help highlight color.
  2382.           bclr:color          Background color.  Same colors as fclr are
  2383.                               available.
  2384.           wrap:on/off         Turn automatic word wrapping on or off.
  2385.           lmgn:size           Left margin size.  Size is a number in units
  2386.                               of tenths of the system font width.  20 is a
  2387.                               recommended margin.
  2388.           rmgn:size           Right margin size, measured in same units
  2389.                               from the right border.
  2390.  
  2391.  
  2392.           46   PM Assistant User's Guide
  2393.  
  2394.  
  2395.           col:position        Column.  Starts display of subsequent text at
  2396.                               the specified position regardless of current
  2397.                               margins.  Position is tenths of the system
  2398.                               font width from left border.
  2399.  
  2400.           You are allowed to distribute up to twenty copies of the
  2401.           demonstration utility pmademo.exe and pmasst.dll dynamic link
  2402.           library to be used to run your demonstration or tutorials.  For
  2403.           more information see Utilis License Agreement on page ii.
  2404.  
  2405.  
  2406.                                                                  Index   47
  2407.  
  2408.  
  2409.  
  2410.  
  2411.                                                     Index                              Index                              Index
  2412.  
  2413.  
  2414.           /e argument, 2                     Demonstration Utility, MK
  2415.           /q argument, 2                      macros, 17
  2416.           Accelerator key                    Demonstration, PM Assistant's,
  2417.             changing with CM macro, 24        45
  2418.             definition, 6                    Desktop Arrangement, 25
  2419.             display of PM Assistant's,       Desktop, definition, 6
  2420.              4                               Dialog box, definition, 6
  2421.           Arguments, PM Assistant's, 2       Display
  2422.           Arguments, prompting for, 12         hot-key and name column
  2423.           Arranging macros, 29                  widths, 27
  2424.           Automated demonstrations, 45         PM Assistant's, 3
  2425.           Build Desktop Arrangement          Document Notes, 5
  2426.            command, 18                       down arrow key, 5
  2427.           Cannot find window error           Duplicating macros, 30
  2428.            message, 15                       Edit clipboard, 6,29
  2429.           Changing macro settings, 10        Edit Copy command, 30
  2430.           Choose Menu Item dialog box,       Edit Cut command, 29
  2431.            22                                Edit Delete command, 30
  2432.           Choose, definition, 6              Edit menu commands, 29
  2433.           Click, definition, 6               Edit Paste command, 29
  2434.           CM macro type, 3,21                Edit Undo command, 30
  2435.           CO macro type, 3,20                Editing a macro's settings, 10
  2436.           Command line, PM Assistant's,      Editing macro listings, 29
  2437.            2                                 end key, 5
  2438.           Command line, SP macro, 12         enter key, 5
  2439.           Comment, macro's, 9                Environment Variable,
  2440.           Compound macro, expanding and       definition, 6
  2441.            collapsing, 31                    Executing `macroname' dialog
  2442.           config.sys, 1,6                     box, 17
  2443.           Control Invoke Both command,       Executing macros, 10,26
  2444.            43                                Executing PM Assistant, 2
  2445.           Control Invoke Password            Exiting PM Assistant, 2
  2446.            Protection command, 43            Expand/Collapse button, 31
  2447.           Control Invoke Screen Saver        Expanding and Collapsing
  2448.            command, 43                        macros, 31
  2449.           Control menu commands, 39          F1 key, 4,5
  2450.           Control Password command, 41       File commands, 35
  2451.           Control Process priority           File New command, 36
  2452.            command, 40                       File Open command, 35
  2453.           Control Screen Saver command,      File Print command, 37
  2454.            42                                File Save As command, 36
  2455.           Control Speed Button command,      File Save command, 36
  2456.            44                                File size, 33
  2457.           Copying macros, 30                 Filename argument, 2
  2458.           Current macro file, 36             Finding macros, 32
  2459.           Customizing menus, 21              Foreground window
  2460.           Deleting all macros, 36              definition, 6
  2461.           Deleting macros, 30                  positioning, 14
  2462.           Demonstration Utility, 45            sending keystrokes to, 19
  2463.  
  2464.  
  2465.           48   PM Assistant User's Guide
  2466.  
  2467.  
  2468.           Full pathname, definition, 6       Macro
  2469.           Full-screen session                  building automatically, 24
  2470.             bringing to the foreground         comment, 3,9
  2471.              with a PW macro, 15               copying, 30
  2472.             definition, 7                      creating, 9
  2473.             delay in responding, 20            Customize Menu type, 21
  2474.             executing macros in, 11            definition, 7
  2475.             monitoring and automatic           deleting, 30
  2476.              invocation of Password            editing commands, 29
  2477.              Protection or Screen              executing, 10,26
  2478.              Saver, 43                         files, 35
  2479.             pointing to, 20                    Group and Compound types,
  2480.             sending keystrokes to with          20
  2481.              a KI macro, 19                    hot-key, 3,9
  2482.             starting with SP macro, 12         Keyboard Input type, 19
  2483.           GR macro type, 3,20                  Mouse & Keyboard input
  2484.           Group macro, expanding and            type, 15
  2485.            collapsing, 31                      name, 3,9
  2486.           Guarantee, ii                        name, display column width,
  2487.           Help, 4                               27
  2488.           home key, 5                          options, 27
  2489.           Hot-key                              Position Window type, 13
  2490.             accepting Tab... while             printing, 37
  2491.              entering, 28                      scrolling, 5
  2492.             definition, 7                      selecting, 5
  2493.             display of, 3                      settings, 10
  2494.             entering, 9                        size in bytes, 34
  2495.             executing a macro with, 11         Start Program type, 11
  2496.             searching for, 32                  type, 3
  2497.             use in an MK macro, 18             viewing, 31
  2498.           Icon, definition, 7                  waiting, 13,14
  2499.           Indicated window, positioning,     Macro Build Desktop
  2500.            14                                 Arrangement command, 25
  2501.           Initial directory, 12              Macro Build Start Programs
  2502.           Initial process priority, 12        Group command, 25
  2503.           Input focus                        Macro Create command, 9
  2504.             definition, 7                    Macro Execute command, 26
  2505.             giving to window, 13             Macro Information dialog box,
  2506.           install.exe, 1                      9,10
  2507.           Installing PM Assistant, 1         Macro menu commands, 9
  2508.           Introduction, 1                    Macro Options command, 27
  2509.           Keyboard Interface, PM             Macro Settings command, 5,10
  2510.            Assistant's, 5                    Macro specifying initial
  2511.           Keystrokes, recording and           position box, 12
  2512.            playing                           Memory statistics, 33
  2513.             with a Keyboard Input            Menu clipboard, 21
  2514.              macro, 19                         definition, 7
  2515.             with a Mouse & Keyboard          Menu, definition, 7
  2516.              input macro, 15                 Merging Macro Files, 36
  2517.           KI macro type, 3,19                Message Box, definition, 7
  2518.           left arrow key, 5                  Minimizing PM Assistant, 28
  2519.           LIBPATH config.sys setting, 1      MK macro portability, 18,28
  2520.           License agreement, ii              MK macro recording resolution,
  2521.           Loading macros from a file, 35      28
  2522.  
  2523.  
  2524.                                                                  Index   49
  2525.  
  2526.  
  2527.           MK macro type, 3,15                Saving macro files, 36
  2528.           MK Recording dialog box hot-       Screen resolutions, 18,28
  2529.            key, 17,28                        Screen Saver, 42
  2530.           Mouse Interface, PM                Scrolling macro list, 5
  2531.            Assistant's, 5                    Searching for macros, 32
  2532.           Mouse, recording & playing         Securing your computer with
  2533.            movements with a Mouse &           Password Protection, 41
  2534.            Keyboard input macro, 15          Select Group dialog box, 25
  2535.           Moving macros, 29                  Select, definition, 7
  2536.           Moving windows, 13                 Selecting a macro, 5
  2537.           New macro files, 36                Session, definition, 7
  2538.           On-line help, 4                    SP macro type, 3,11
  2539.           Opening macro files, 35            SP macros, building sets of,
  2540.           Parameters, PM Assistant's, 2       25
  2541.           Parameters, SP macro, 12           Speed Button, 44
  2542.           Password Protection, 41            Start Program dialog box, 11
  2543.           Pasting macros, 29                 Start Program macro, 39
  2544.           Path environment variable, 12      Start Program macro, called
  2545.           Pausing a MK macro, 17              from Position Window macro,
  2546.           pg down key, 5                      14
  2547.           pg up key, 5                       Start Programs application
  2548.           Playback rate, MK macro, 16          compared with SP macro, 11
  2549.           PM program, starting with SP         importing information from,
  2550.            macro, 12                            25
  2551.           PM text window, 12                 Starting PM Assistant, 2
  2552.           PM, definition, 7                  Starting programs with PM
  2553.           Pointing to window, 15              Assistant, 11
  2554.           Position Window dialog box, 13     Status/Help line, 3,34,36
  2555.           Position Window Macro, 13            suppressing, 33
  2556.           Presentation Manager               Switching between windows, 13
  2557.            clipboard, 29                     Terms, 6
  2558.           Printing macro lists, 37           Thread, definition, 7
  2559.           Priority class, 39                 Undoing edit commands, 30
  2560.           Priority number, 39                up arrow key, 5
  2561.           Process priorities, 39             View Expand All command, 32
  2562.           Process priority, setting with     View Expand command, 31
  2563.            SP macro, 12                      View Find command, 29
  2564.           Process,definition, 7              View Find Macro command, 32
  2565.           Program run method, 12             View Find Next command, 33
  2566.           PW macro type, 3,13                View Memory Stats command, 34
  2567.           PW macros, building sets of,       View menu commands, 31
  2568.            25                                View Status/Help command, 33
  2569.           Question mark (?) argument, 12     Window
  2570.           Quitting PM Assistant, 2             appearing, 14
  2571.           Recording `macroname' dialog         definition, 8
  2572.            box, 17                             moving, 13
  2573.           Recording keystrokes, 19             not finding, 14
  2574.           Recovering deleted macro, 30         pointing to, 15
  2575.           Removing the Status/Help line,
  2576.            33
  2577.           Renaming menu items, 23
  2578.           Restoring windows, 13
  2579.           right arrow key, 5
  2580.           Running PM Assistant, 2