home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
OS/2 Shareware BBS: 11 Util
/
11-Util.zip
/
pma20.zip
/
PMAHELP.PMH
< prev
next >
Wrap
Text File
|
1994-08-16
|
66KB
|
1,600 lines
{head: 2701}
{index:Index: 2777: 1205}
{index:Introduction: 3982: 1679}
{index:Using Help: 5661: 1616}
{index:Contacting Utilis: 7277: 584}
{index:-------General Topics----------: 7861: 298}
{indexalias:Creating Macros:Create command}
{index:Display: 8284: 3229}
{indexalias:Desktop Arrangement:Macro Build Arrangement command}
{indexalias:Editing Macro Settings:Macro Settings command}
{indexalias:Editing the Macro List:Edit commands}
{index:Drag & Drop: 11770: 669}
{index:Executing Macros: 12439: 1140}
{indexalias:Exiting PM Assistant:File Exit command}
{index:Keyboard: 13713: 2065}
{indexalias:Keyboard Macros: Keyboard Input macro}
{index:Merging Files: 15911: 530}
{index:Mouse: 16441: 825}
{indexalias:Moving Windows: Position Window macro}
{indexalias:Password Protection:Control Password command}
{indexalias:Saving Macros:File Save command}
{indexalias:Scheduling macros and programs to run:Macro Date & Time command}
{indexalias:Screen Saver:Control Screen Saver command}
{index:Starting PM Assistant: 17638: 1192}
{indexalias:Starting Programs: Start Program macro}
{indexalias:Technical Support:Contacting Utilis}
{index:-------Commands---------------: 19013: 291}
{index:File Open command: 19304: 1395}
{index:File Save command: 20699: 905}
{index:File Save As command: 21604: 603}
{index:File New command: 22207: 518}
{index:File Print command: 22725: 532}
{index:File Exit command: 23257: 1033}
{index:File About command: 24290: 370}
{index:Edit commands: 24660: 3144}
{index:Macro Settings command: 27804: 2003}
{index:Macro Date & Time command: 29807: 2812}
{index:Macro Execute command: 32619: 1954}
{index:Macro Disable command: 34573: 994}
{index:Macro Disable All command: 35567: 1062}
{index:Macro Options command: 36629: 4293}
{index:Create command: 40922: 552}
{index: Start Program macro: 41474: 2620}
{index: Position Window macro: 44094: 3715}
{index: Keyboard Input macro: 47809: 1959}
{index: Compound macro: 49768: 1313}
{index: Group macro: 51081: 888}
{index: Message macro: 51969: 1065}
{index:Macro Build Arrangement command: 53034: 982}
{index:View Expand command: 54016: 829}
{index:View Expand All command: 54845: 975}
{index:View Find Macro command: 55820: 1781}
{index:View Find Next command: 57601: 619}
{index:View Status/Help Line command: 58220: 511}
{index:View Memory Stats command: 58731: 893}
{index:Control Invoke commands: 59624: 1097}
{index:Control Password command: 60721: 2219}
{index:Control Screen Saver command: 62940: 2068}
{index:Supply parameters box: 65008: 554}
{index:Compound macro box: 65562: 763}
{comment: PM Assistant help file. Copyright (C) 1990-94 Utilis Inc. }\
\
{sect:Index}\
{bclr:bhelp}\
{showindex}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Using The Index
{n,pt:10,fclr:fhelp,col:60}\
Select a help topic from the list box with the up and down arrow keys
or by clicking on the topic. To display the topic in the help window
type
{font:sys,pt:12,fclr:fstd}Enter{font:helv,pt:10,fclr:fhelp}
or double click on the topic name.
{n}{n}The Index is broken into three sections:
{n,col:40}1.{col:70,lmgn:70}Introductory Topics. This section contains the Index,
Introduction, and Using Help (this topic) topics.
{n,col:40}2.{col:70}General Topics. This section contains general topics
listed in alphabetical order.
{n,col:40}3.{col:70}Commands. This section lists the commands in the order
they are arranged in PM Assistant's menus.
{n,lmgn:20}{n}A topic may be referred to by more than one index entry.
{n}{n}You can dismiss the index window by choosing
{font:sys,pt:12,fclr:fstd}Close{font:helv,pt:10,fclr:fhelp}
from it's system menu or typing
{font:sys,pt:12,fclr:fstd}Esc{font:helv,pt:10,fclr:fhelp}.
{n}{n,pt:8,fclr:palegray}[Release code: 090194]
{comment: --------------- Introduction --------------------------------}
{sect:Introduction}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14}Introducing:{n}
{pt:24,fclr:fstd,col:100,font:TmsRmn}PM Assistant
{n,pt:10,font:Helv,fclr:fhelp,col:60}\
PM Assistant is an OS/2 Presentation Manager automation and
customization utility. With it you can automate repetitive tasks and
customize how you work with OS/2 Presentation Manager.
{n}{n}You use PM Assistant by creating, editing and running
macros. There are six types of macros, each of which performs
a different Presentation Manager task:
{wrap:off,pt:10,lmgn:70}
{n,col:40}1.{col:70,fclr:fstd}Start Program {fclr:fhelp}macro
{n,col:40}2.{col:70,fclr:fstd}Position Window {fclr:fhelp}macro
{n,col:40}3.{col:70,fclr:fstd}Keyboard Input {fclr:fhelp}macro
{n,col:40}4.{col:70,fclr:fstd}Compound Macro {fclr:fhelp}macro
{n,col:40}5.{col:70,fclr:fstd}Group Macro {fclr:fhelp}macro
{n,col:40}6.{col:70,fclr:fstd}Message Macro {fclr:fhelp}macro
{n,wrap:on,pt:10,lmgn:20}
{n}Macros can be assigned Hot-keys. Whenever the hot-key is typed the
associated macro is executed. Hot-keys are recognized
when you are viewing the OS/2 desktop. Macros are not recognized when viewing
a full screen WIN-OS2 or DOS prompt.
{n}{n}PM Assistant also comes with Screen Saver and Password Protection
features. Screen Saver will blank the screen after a certain period
of inactivity to prevent image burn-in on you monitor. Password
Protection can be configured to require a password after a certain period
of inactivity. Having such a password will prevent unauthorized access to
your computer & data.
{comment:-------------------------- Using help --------------------------}
{sect:Using Help}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Using Help
{n,pt:10,fclr:fhelp,col:60}\
The PM Assistant help system displays information about the
PM Assistant program.
{n}{n}You can choose a topic to be displayed from
the Help Index by double-clicking on the topic title. Use the
{font:sys,pt:12,fclr:fstd}Index{font:helv,pt:10,fclr:fhelp}
menu command at the top of this help window to display the index.
{n}{n}The Index is broken into three sections:
{n,col:40}1.{col:70,lmgn:70}Introductory Topics. This section contains the Index,
Introduction, Using Help (this topic) and Contacting Utilis topics.
{n,col:40}2.{col:70}General Topics. This section contains general topics
listed in alphabetical order.
{n,col:40}3.{col:70}Commands. This section lists the commands in the order
they are arranged in PM Assistant's menus.
{n,lmgn:20}{n}You can browse the help topics by choosing the
{font:sys,pt:12,fclr:fstd}Next{font:helv,pt:10,fclr:fhelp} and
{font:sys,pt:12,fclr:fstd}Prev{font:helv,pt:10,fclr:fhelp} menu commands
at the top of this help window.
{n}{n}If you
choose the
{font:sys,pt:12,fclr:fstd}help{font:helv,pt:10,fclr:fhelp} button
in a PM Assistant dialog box, the topic associated
with that dialog box will be displayed directly.
{n}{n}Type
{font:sys,pt:12,fclr:fstd}Esc{font:helv,pt:10,fclr:fhelp} or choose the
{font:sys,pt:12,fclr:fstd}Exit{font:helv,pt:10,fclr:fhelp}
menu command at the top of this help window to exit this help window.
{comment:-------------------------- Contacting Utilis ------------------------}
{sect:Contacting Utilis}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:TmsRmn,style:italic,pt:24,fclr:fstd}\
Utilis
{pt:12,style:normal}Advanced Tools Now
{n,pt:12,font:Helv}P.O. Box 367
{n}Redmond, Washington 98073-0367
{n}{n}General inquiries and technical support: {style:bold}(206) 467-4025
{n,style:normal}Orders: {style:bold}1-800-745-7757
{n,style:normal}{n}Utilis is dedicated to providing advanced tools for advanced
operating environments. We welcome all comments and suggestions.
{comment: --------------- General Topics ------------------------------------}
{sect:-------General Topics----------}\
{bclr:bhelp}\
{showindex}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
General Topics
{n,pt:10,fclr:fhelp,col:60}\
This section of the index contains help on general topics listed in
alphabetical order. Choose a topic to view from the index.
{indexalias:Creating Macros:Create command}
{comment: --------------- Display ---------------------------------------}
{sect:Display}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
The PM Assistant Display
{n,pt:10,fclr:fhelp,col:60}\
There are three regions in the PM Assistant
display: the column headers, the macro list, and the Status/Help line.
{n}{n,style:bold}Column Headers{style:normal,n}
The column headers identify the five columns which can be displayed.
You can change the width of a column by clicking and dragging on the line
separating the columns on the column header. You cannot resize the
{style:bold,fclr:fstd}Type{style:normal,fclr:fhelp} column. You can automatically size a column to fit
the longest string by double clicking on that column header.
{n}{n,style:bold}Macro List{style:normal,n}
The macro list display region displays the macros currently loaded in PM
Assistant, one macro per line. If no macros are currently loaded, the
macro list display region displays
{font:sys,pt:12,fclr:fstd}No Macros{font:helv,pt:10,fclr:fhelp}.
Each macro line is divided into four fields:
{n,wrap:off,font:sys,pt:12,fclr:fstd}\
Button {fclr:red}Hot-key {fclr:fstd}Abr Name Comment
{n,wrap:on}{n,font:sys,pt:12}Button \
{font:helv,pt:10,fclr:fhelp}Press the button to immediately execute the macro.
{n}{n,font:sys,pt:12,fclr:red}Hot-key \
{font:helv,pt:10,fclr:fhelp}The hot-key associated with the macro. Typing
the hot-key executes the macro.
{n}{n,font:sys,pt:12,fclr:fstd}Abr \
{font:helv,pt:10,fclr:fhelp}An abbreviation for the macro type. The
abbreviations are:
{n,font:sys,pt:12,fclr:fstd,lmgn:50}SP {font:helv,pt:10,col:120}\
Start Program {fclr:fhelp}macro
{n,font:sys,pt:12,fclr:fstd}PW {font:helv,pt:10,col:120}\
Position Window {fclr:fhelp}macro
{n,font:sys,pt:12,fclr:fstd}KI {font:helv,pt:10,col:120}\
Keyboard Input {fclr:fhelp}macro
{n,font:sys,pt:12,fclr:fstd}CO {font:helv,pt:10,col:120}\
Compound {fclr:fhelp}macro
{n,font:sys,pt:12,fclr:fstd}GR {font:helv,pt:10,col:120}\
Group {fclr:fhelp}macro
{n,font:sys,pt:12,fclr:fstd}MS {font:helv,pt:10,col:120}\
Message {fclr:fhelp}macro
{n}{n,font:sys,pt:12,fclr:fstd,lmgn:20}Name \
{font:helv,pt:10,fclr:fhelp}The macro's name.
{n}{n,font:sys,pt:12,fclr:fstd}Comment \
{font:helv,pt:10,fclr:fhelp}The macro's comment.
{n}{n}Macros in the body of {fclr:fstd}Compound{fclr:fhelp} or
{fclr:fstd}Group{fclr:fhelp} macros are indented and delineated by
lines. The display of macros within the body of a
{fclr:fstd}Compound{fclr:fhelp} or {fclr:fstd}Group{fclr:fhelp} macro
can be expanded or collapsed with the
{font:sys,pt:12,fclr:fstd}View Expand{font:helv,pt:10,fclr:fhelp}
command or by clicking
on the {fclr:fstd}(+){fclr:fhelp} or {fclr:fstd}(-){fclr:fhelp}
symbol displayed in front of the macro's name.
{n}{n,style:bold}Status/Help line{style:normal,n}
The Help/Status line usually displays PM Assistant's status. When
executing a macro or reading a file, the Help/Status line reports that.
When PM Assistant is idle the Status/Help line displays
{font:sys,pt:12,fclr:fstd}Ready{font:helv,pt:10,fclr:fhelp}.
{n}{n}While traversing PM Assistant's menus, the Help/Status line displays
description of the selected menu command.
{indexalias:Desktop Arrangement:Macro Build Arrangement command}
{indexalias:Editing Macro Settings:Macro Settings command}
{indexalias:Editing the Macro List:Edit commands}
{comment: --------------- Drag & Drop----------------------------------}
{sect:Drag & Drop}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Drag & Drop
{n,pt:10,fclr:fhelp,col:60}\
You can drag & drop macros within the macro list. Click on the macro to
drag and hold down the left mouse button. Drag the macro up or down and notice
a horizontal line appears under the mouse. This line indicates where the macro
would be dropped if you released the mouse button.
{n}{n}Holding down the
{font:sys,pt:12,fclr:fstd}Ctrl{font:helv,pt:10,fclr:fhelp} key while you drag
{style:italic}copies{style:normal} the macro rather than moving it.
{comment: --------------- Executing Macros --------------------------------}
{sect:Executing Macros}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Executing Macros
{n,pt:10,fclr:fhelp,col:60}\
There are six ways to execute a macro:
{n,lmgn:70}
{n,col:40}1.{col:70}Type the hot-key associated with the macro.
{n,col:40}2.{col:70}Press the button associated with the macro.
{n,col:40}3.{col:70}Double-click on the macro in the PM Assistant macro list
display.
{n,col:40}4.{col:70}Schedule the macro to be executed on a particular day at
a particular time with the
{font:sys,pt:12,fclr:fstd}Macro Date & Time{font:helv,pt:10,fclr:fhelp}
menu command.
{n,col:40}5.{col:70}Select the macro in the PM Assistant macro list by
scrolling through the macro list with the up and down arrow keys or by clicking on it.
Then type
{font:sys,pt:12,fclr:fstd}Enter{font:helv,pt:10,fclr:fhelp}
to execute the selected macro.
{n,col:40}6.{col:70}Select the macro as in 5. and choose the
{font:sys,pt:12,fclr:fstd}Macro Execute{font:helv,pt:10,fclr:fhelp}
menu command. This will activate a dialog box which gives more control
over executing the macro. See the Macro Execute command help topic.
{indexalias:Exiting PM Assistant:File Exit command}
{comment: --------------- Keyboard ---------------------------------------}
{sect:Keyboard}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Keyboard
{n,pt:10,fclr:fhelp,col:60}\
Menu command accelerator keys are displayed in the Status/Help
line when a menu command is selected.
{n}{n}PM Assistant recognizes the following keystrokes:
{lmgn:20,n}{n,font:sys,pt:12,fclr:fstd}F1
{col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Help
{lmgn:20,n,font:sys,pt:12,fclr:fstd}Enter
{col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Execute the selected macro.
{lmgn:20,n}{n,font:sys,pt:12,fclr:fstd}PgUp
{col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Scroll the macro list back one page.
{lmgn:20,n,font:sys,pt:12,fclr:fstd}PgDn
{col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Scroll the macro list forward one page.
{lmgn:20,n,font:sys,pt:12,fclr:fstd}Home
{col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Scroll to the beginning of the macro list.
{lmgn:20,n,font:sys,pt:12,fclr:fstd}End
{col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Scroll to the end of the macro list.
{lmgn:20,n,font:sys,pt:12,fclr:fstd}Up
{col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Move the macro selection up one macro.
{lmgn:20,n,font:sys,pt:12,fclr:fstd}Down
{col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Move the macro selection down one macro.
{lmgn:20,n,font:sys,pt:12,fclr:fstd}Left
{col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Select the first displayed macro.
{lmgn:20,n,font:sys,pt:12,fclr:fstd}Right
{col:110,lmgn:110,font:helv,pt:10,fclr:fhelp}Scroll to the selected macro.
{n}
{lmgn:20,n,font:sys,pt:12,fclr:fstd}Shft+Del
{col:130,lmgn:130}Edit Cut{font:helv,pt:10,fclr:fhelp} command
{lmgn:20,n,font:sys,pt:12,fclr:fstd}Shft+Ins
{col:130,lmgn:130}Edit Paste{font:helv,pt:10,fclr:fhelp} command
{lmgn:20,n,font:sys,pt:12,fclr:fstd}Ctrl+Ins
{col:130,lmgn:130}Edit Insert{font:helv,pt:10,fclr:fhelp} command
{lmgn:20,n,font:sys,pt:12,fclr:fstd}Del
{col:130,lmgn:130}Edit Delete{font:helv,pt:10,fclr:fhelp} command
{lmgn:20,n,font:sys,pt:12,fclr:fstd}Alt+Bksp
{col:130,lmgn:130}Edit Undo{font:helv,pt:10,fclr:fhelp} command
{indexalias:Keyboard Macros: Keyboard Input macro}
{comment: --------------- Merging Files ----------------------------------}
{sect:Merging Files}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Merging Files
{n,pt:10,fclr:fhelp,col:60}\
To merge macro files, choose the
{font:sys,pt:12,fclr:fstd}File Open{font:helv,pt:10,fclr:fhelp}
menu command and click the
{fclr:fstd,font:sys,pt:12}Insert{fclr:fhelp,font:helv,pt:10}
radio button. The macros from the chosen file will be inserted into
the current macro list, thus effectively merging the files.
{comment: --------------- Mouse ------------------------------------------}
{sect:Mouse}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Mouse
{n,pt:10,fclr:fhelp,col:60}\
PM Assistant recognizes the following mouse actions:
{n}{n,lmgn:20,n,font:sys,pt:12,fclr:fstd}Left button
{n,lmgn:70,font:helv,pt:10,fclr:fhelp}Selects the macro under the
mouse pointer.
{n}{n,lmgn:20,n,font:sys,pt:12,fclr:fstd}Double-click Left button
{n,lmgn:70,font:helv,pt:10,fclr:fhelp}Executes the macro under the
mouse pointer.
{n}{n,lmgn:20,n,font:sys,pt:12,fclr:fstd}Right button
{n,lmgn:70,font:helv,pt:10,fclr:fhelp}Macro Settings command applied to
the macro under the mouse pointer.
{n}{n}You can move macros within the macro list using the mouse to Drag & Drop.
See the Drag & Drop help topic.
{comment:----------------- Some Index Aliases ----------------------------}
{indexalias:Moving Windows: Position Window macro}
{indexalias:Password Protection:Control Password command}
{indexalias:Saving Macros:File Save command}
{indexalias:Scheduling macros and programs to run:Macro Date & Time command}
{indexalias:Screen Saver:Control Screen Saver command}
{comment: --------------- Starting PM Assistant --------------------------}
{sect:Starting PM Assistant}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Starting PM Assistant
{n,pt:10,fclr:fhelp,col:60}\
PM Assistant can be started from an OS/2 command prompt with the following
syntax:
{n}{n,fclr:fstd}pmasst [filename] [/e macroname] [/q] [/m]
{n}{n,fclr:fhelp}The command line arguments are optional:
{n}{n,fclr:fstd}filename{fclr:fhelp} - PM Assistant loads the named macro
file immediately.
{n}{n,fclr:fstd}/e macroname{fclr:fhelp} - PM Assistant executes the named
macro immediately. You can have any number of /e arguments on the command
line; the macros are executed in order from left to right.
{n}{n,fclr:fstd}/q{fclr:fhelp} - PM Assistant quits after any macros have
been executed using the /e argument.
{n}{n,fclr:fstd}/m{fclr:fhelp} - PM Assistant starts in a minimized state. This is
useful because often you will only be using hot-keys and won't need to view
PM Assistant's window.
{n}{n}By using the {fclr:fstd}filename /e macroname /q{fclr:fhelp} arguments,
you can use PM Assistant to run macros from within .cmd files.
{comment:----------------- Some Index Aliases ----------------------------}
{indexalias:Starting Programs: Start Program macro}
{indexalias:Technical Support:Contacting Utilis}
{comment: --------------- Commands ------------------------------------}
{sect:-------Commands---------------}\
{bclr:bhelp}\
{showindex}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Commands
{n,pt:10,fclr:fhelp,col:60}\
Choose the command to view help about from the index.
{comment:-------------------------- File Open ----------------------------}
{sect:File Open command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
File Open command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}File Open{font:helv,pt:10,fclr:fhelp}
command loads macro from a file.
{n}{n}Enter the filename into the topmost
{font:sys,pt:12}Filename:{font:helv,pt:10} edit box,
or chose a filename using the {font:sys,pt:12}Directories:{font:helv,pt:10}
and {font:sys,pt:12}Files:{font:helv,pt:10} list boxes.
{n}{n}Checking the
{fclr:fstd,font:sys,pt:12}Replace{fclr:fhelp,font:helv,pt:10}
radio button causes the current
list of macros to be replaced by the new list of macros.
{n}{n}Checking the
{fclr:fstd,font:sys,pt:12}Insert{fclr:fhelp,font:helv,pt:10}
radio button causes the new
list of macros to be inserted into the current list of macros just after
the currently selected macro. This effectively merges the two lists of macros.
{n}{n}Checking the
{fclr:fstd,font:sys,pt:12}File is read only{fclr:fhelp,font:helv,pt:10}
check box disables
the File Save menu command preventing you from accidentally modifying the
file.
{n}{n}Double clicking on a filename in the
{font:sys,pt:12}Files:{font:helv,pt:10}
list box or clicking the {font:sys,pt:12}Load{font:helv,pt:10}
button causes the indicated file to be loaded.
{comment:-------------------------- File Save ----------------------------}
{sect:File Save command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
File Save command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}File Save{font:helv,pt:10,fclr:fhelp}
command saves the macro list to the current file.
The filename of the current file is displayed in the
{font:sys,pt:12,fclr:fstd}File Save 'filename'{font:helv,pt:10,fclr:fhelp}
menu item. If there is no current file you will be prompted for a filename.
{n}{n}If you have made changes to the current list of macros and exit
PM Assistant, PM Assistant will ask if you'd like to save the changes before
exiting.
{n}{n}When you choose the
{font:sys,pt:12,fclr:fstd}File{font:helv,pt:10,fclr:fhelp}
menu command, the Help/Status
line displays whether or not the current macro list has been modified.
{comment:-------------------------- File Save As ----------------------------}
{sect:File Save As command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
File Save As command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}File Save As{font:helv,pt:10,fclr:fhelp}
command saves the macro list to a specified file. The
default extension for a file containing PM Assistant macros is .pma.
{n}{n}Enter the filename into the
{font:sys,pt:12}Filename:{font:helv,pt:10} edit box.
{n}{n}If the entered file exists, you will be asked to confirm
overwriting that file.
{comment:-------------------------- File New ----------------------------}
{sect:File New command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
File New command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}File New{font:helv,pt:10,fclr:fhelp}
command discards the current list of macros in
preparation for creating new macros.
{n}{n}If the current list of macros has not been saved to a file
you will be asked whether you first want to save the current list of macros.
{comment:-------------------------- File Print ----------------------------}
{sect:File Print command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
File Print command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}File Print{font:helv,pt:10,fclr:fhelp}
command prints a textual listing of the macros to
a file.
{n}{n}Enter the filename into the
{font:sys,pt:12}Filename:{font:helv,pt:10} edit box.
{n}{n}If the entered file exists, you will be asked to confirm
overwriting that file.
{comment:-------------------------- File Exit ----------------------------}
{sect:File Exit command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
File Exit command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}File Exit{font:helv,pt:10,fclr:fhelp}
command exits PM Assistant.
{n}{n}If programs you have started with PM Assistant are still running,
you will be asked if you want to terminate those programs. You cannot
exit PM Assistant and leave programs started by PM Assistant running.
{n}{n}If the current list of macros has not been saved to a file
you will be asked whether you first want to save the current list of macros.
{n}{n}Use the -q command line flag to have PM Assistant exit immediately after
executing any macros. For example, starting PM Assistant with the:
{n} PMASST -e amacro -q
{n}directs PM Assistant to execute the macro 'amacro' and then exit. With this
method you can execute macros directly from the command line or from other
applications.
{comment:-------------------------- File About ----------------------------}
{sect:File About command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
File About command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}File About{font:helv,pt:10,fclr:fhelp}
command displays information about PM Assistant
including the version number.
{comment:-------------------------- Edit commands -----------------------}
{sect:Edit commands}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Edit commands
{n,pt:10,fclr:fhelp,col:60}\
The
{fclr:fstd}Edit{fclr:fhelp}
commands let you edit the macro list - rearranging, duplicating, or
discarding macros. Macros are moved to and from the macro clipboard. The
name of the macro on the macro clipboard appears at the bottom of the
{fclr:fstd}Edit{fclr:fhelp}
menu.
{n}{n}You can also move macros within the macro list using Drag & Drop. See
the Drag & Drop help topic.
{n}{n}When macros are inserted from the clipboard they are inserted
{style:italic}after {style:normal}the currently selected macro. If the
currently selected macro is a
{fclr:fstd}Compound{fclr:fhelp} or
{fclr:fstd}Group{fclr:fhelp} macro, macros are inserted
{style:italic}into {style:normal}the body if the
{fclr:fstd}Compound{fclr:fhelp} or
{fclr:fstd}Group{fclr:fhelp} macro's body is expanded (see the View
Expand command).
{n}{n}When a {fclr:fstd}Compound{fclr:fhelp} or
{fclr:fstd}Group{fclr:fhelp} macros is moved with the
{fclr:fstd}Edit{fclr:fhelp}
commands, the macro and the macros comprising it's body are moved as one.
{n}{n}The macro clipboard is not the same as the PM clipboard and
macros cannot be cut or pasted to other PM programs.
{n}{n,font:helv,pt:14,fclr:fstd}
Edit Cut command
{n,pt:10,fclr:fhelp,col:80}
The
{font:sys,pt:12,fclr:fstd}Edit Cut{font:helv,pt:10,fclr:fhelp}
command cuts the currently selected macro from the macro list
and places it on the macro clipboard. If the macro clipboard already
contains a macro, you will asked if you wish to discard that macro.
{n}{n,font:helv,pt:14,fclr:fstd}
Edit Paste command
{n,pt:10,fclr:fhelp,col:80}
The
{font:sys,pt:12,fclr:fstd}Edit Paste{font:helv,pt:10,fclr:fhelp}
command pastes the macro from the macro clipboard into the
macro list.
{n}{n,font:helv,pt:14,fclr:fstd}
Edit Copy command
{n,pt:10,fclr:fhelp,col:80}
The
{font:sys,pt:12,fclr:fstd}Edit Copy{font:helv,pt:10,fclr:fhelp}
command copies the currently selected macro from the macro list
and places it on the macro clipboard. Since macro names should generally
be kept unique, the name of the copy on the clipboard is "incremented" - a
2 is added to the end, or if the macro ends in a number that number is
incremented.
{n}{n,font:helv,pt:14,fclr:fstd}
Edit Delete command
{n,pt:10,fclr:fhelp,col:80}
The
{font:sys,pt:12,fclr:fstd}Edit Delete{font:helv,pt:10,fclr:fhelp}
command deletes the currently selected macro from the macro
list. The deleted macro can be recovered with the
{font:sys,pt:12,fclr:fstd}Edit Undo{font:helv,pt:10,fclr:fhelp}
command.
{n}{n,font:helv,pt:14,fclr:fstd}
Edit Undo command
{n,pt:10,fclr:fhelp,col:80}
The
{font:sys,pt:12,fclr:fstd}Edit Undo{font:helv,pt:10,fclr:fhelp}
command undoes that last edit operation. You can undo only
one edit operation - choosing the
{font:sys,pt:12,fclr:fstd}Edit Undo{font:helv,pt:10,fclr:fhelp}
command a second time redoes the original edit operation.
{comment:-------------------------- Macro Settings--------------------------}
{sect:Macro Settings command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Macro Settings command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}Macro Settings{font:helv,pt:10,fclr:fhelp}
command allows you to edit the settings associated with
the currently selected macro. You can also edit a macro's settings by
clicking the right mouse button on it in the macro list display.
{n}{n}All types of macros have the following settings:
{n}{n,font:sys,pt:12}Name: {font:helv,pt:10,col:140}The name of the macro.
{n}{n,font:sys,pt:12}Comment: {font:helv,pt:10,col:140}A comment describing
the macro.
{n}{n,font:sys,pt:12}Hot-key: {font:helv,pt:10,col:140}The Hot-key associated
with the macro. This is a key sequence, which, when typed from anywhere in
OS/2 invokes the macro. Type the key sequence as you would when using the
hot-key. For example, to enter the F5 key as a hot-key, hit the F5 key
itself -- you need not spell out 'F' '5'. While entering a hot-key typing a
backspace is the same as clicking the
{font:sys,pt:12,fclr:fstd}Clear hot-key {font:helv,pt:10,fclr:fhelp}button,
it clears the entire hot-key sequence. Hot-keys can be any number of
keystrokes long.
{n}{n}These settings are displayed for each macro in the macro list window.
Each type of macro, except for
{fclr:fstd}Compound{fclr:fhelp} or
{fclr:fstd}Group{fclr:fhelp} macros,
has additional settings specific to that type of macro.
To view or change these additional settings click the
{font:sys,pt:12,fclr:fstd}Settings... {font:helv,pt:10,fclr:fhelp}button.
{n}{n}To accept the settings and return to the main PM Assistant window click
the
{font:sys,pt:12,fclr:fstd}Done {font:helv,pt:10,fclr:fhelp}button.
{n}{n}To preserve the original settings and return to the main PM
Assistant window click the
{font:sys,pt:12,fclr:fstd}Cancel {font:helv,pt:10,fclr:fhelp}button.
{comment:-------------------------- Macro Date & Time -----------------}
{sect:Macro Date & Time command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Macro Date & Time command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}Macro Date & Time{font:helv,pt:10,fclr:fhelp}
command allows you to schedule the currently selected macro to execute at
a specific or recurring date and time. You can also schedule a macro by clicking
on the clock icon to the left of the macro type abbreviation in the macro list display.
{n}{n}To schedule a program to run at a particular time, create a
{fclr:fstd}Start Program{fclr:fhelp} type of macro and specify within that macro
the program to run.
{n}{n}The Date & Time dialog box has the following settings:
{n}{n,font:sys,pt:12}Once on {font:helv,pt:10,col:140}The date on which to execute
the macro. The date should be in a MM/DD/YY format. If this option is selected
the macro is executed once on that day at the time specified in the
{font:sys,pt:12}Daily at...o'clock{font:helv,pt:10} field.
{n}{n,font:sys,pt:12}Daily at...o'clock {font:helv,pt:10,col:140}The time at which to
execute the macro. The time should be in a HH:MM format. If this option is selected
the macro is executed every day at that time.
{n}{n,font:sys,pt:12}Weekly on...{font:helv,pt:10,col:140}The days of the week on which
to execute the macro. Any combination of days may be selected. If this option is
selected the macro is executed on each day specified at the time specified in the
{font:sys,pt:12}Daily at...o'clock{font:helv,pt:10} field.
{n}{n,font:sys,pt:12}Monthly on the...{font:helv,pt:10,col:140}The day of
the month on which to execute
the macro. If this option is selected
the macro is executed once every month on the day selected
at the time specified in the {font:sys,pt:12}Daily at...o'clock{font:helv,pt:10} field.
{n}{n,font:sys,pt:12}Every...hours{font:helv,pt:10,col:140}The frequency at which
to execute the macro. The frequency should be in a HH:MM format.
If this option is selected the macro is executed every HH:MM hours. For example,
if 00:30 were specified, the macro would be executed every thirty minutes for as
long as that macro list is loaded into PM Assistant.
{n}{n,font:sys,pt:12}Each time macro file is loaded
{font:helv,pt:10,col:140}If this option is selected the macro is executed once each
time the macro file is loaded. This is useful if a macro file is distributed to
perform a specific task in which case the users need only to load the file to
accomplish the task.
{n}{n,font:sys,pt:12}Manually{font:helv,pt:10,col:140}
If this option is selected the macro is not executed automatically at any
specific time. This is the default for all macros.
{comment:-------------------------- Macro Execute command -------------------}
{sect:Macro Execute command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Macro Execute command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}Macro Execute{font:helv,pt:10,fclr:fhelp}
command executes the currently selected macro in special
ways. The following settings control how the macro is executed:
{n}{font:sys,pt:12,fclr:fstd,n}Execute once \
{font:helv,pt:10,fclr:fhelp}Executes the macro once.
{n}{font:sys,pt:12,fclr:fstd,n}Execute ... times \
{font:helv,pt:10,fclr:fhelp}Executes the macro the given number of times.
Enter the number of times into the edit field. You can abort the macro
while it is executing by typing Ctrl+C.
{n}{font:sys,pt:12,fclr:fstd,n}Execute indefinitely \
{font:helv,pt:10,fclr:fhelp}Executes the macro repeatedly until you
abort the macro by typing Ctrl+C.
{n}{n}{font:sys,pt:12,fclr:fstd}Execute Compound macro in random order \
{font:helv,pt:10,fclr:fhelp}If the currently selected macro is a
{fclr:fstd}Compound{fclr:fhelp} macro this setting causes the macros
comprising it's body to be executed in random order rather than sequential
order. This is useful for setting up automated demonstrations to run at a
trade convention, or for running automated software tests in random order.
{n}{font:sys,pt:12,fclr:fstd,n}Block all input during execution \
{font:helv,pt:10,fclr:fhelp}Blocks all user mouse and keyboard input
during the execution of the macro. This is useful for setting up
unattended demonstrations. Using this setting prevents observers from
breaking the demonstration by typing randomly on the keyboard (which
observers are prone to do during unattended demonstrations). Typing
Ctrl+C will still abort the macro.
{n}{n}Click the {font:sys,pt:12,fclr:fstd}Execute{font:helv,pt:10,fclr:fhelp}
button to execute the macro.
{comment:-------------------------- Macro Disable command -------------------}
{sect:Macro Disable command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Macro Disable command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}Macro Disable{font:helv,pt:10,fclr:fhelp}
command disables the hot-key of the currently
selected macro. Disabling a macro's hot-key prevents PM Assistant from
executing the macro when the hot-key is typed.
{n}{n}The hot-key of a macro who's hot-key is disabled is blue in the PM
Assistant macro list display.
{n}{n}You can still execute a
macro who's hot-key is disabled with the
{font:sys,pt:12,fclr:fstd}Macro Execute{font:helv,pt:10,fclr:fhelp}
command, by double-clicking on it in the
PM Assistant macro list display, or selecting the macro and hitting the
enter key.
{n}{n}Choosing the
{font:sys,pt:12,fclr:fstd}Macro Disable{font:helv,pt:10,fclr:fhelp}
command again re-enables the selected macro's hot-key.
{comment:-------------------------- Macro Disable All command -------------}
{sect:Macro Disable All command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Macro Disable All command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}Macro Disable All{font:helv,pt:10,fclr:fhelp}
command disables the hot-keys of all macros.
Disabling all hot-keys prevents PM Assistant from executing any macros
when a hot-key is typed. A check mark appears next to the
{font:sys,pt:12,fclr:fstd}Macro Disable All{font:helv,pt:10,fclr:fhelp}
menu item.
{n}{n}All hot-keys are blue in the macro list display to indicate they are
disabled.
{n}{n}You can still execute a
macro who's hot-key is disabled by double-clicking on the macro name in the
PM Assistant macro list display.
{n}{n}Choosing the
{font:sys,pt:12,fclr:fstd}Macro Disable All{font:helv,pt:10,fclr:fhelp}
command again re-enables the hot-keys.
The check mark next to the
{font:sys,pt:12,fclr:fstd}Macro Disable All{font:helv,pt:10,fclr:fhelp}
menu item is removed.
{comment:------------------------ Macro Options command ---------------}
{sect:Macro Options command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Macro Options command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}Macro Options{font:helv,pt:10,fclr:fhelp}
command lets you change the way PM Assistant behaves
in various ways. The Macro Options dialog box has the following settings:
{n}{n,font:sys,pt:12}Display field widths: \
{font:helv,pt:10}These settings control the widths of display fields in the
macro display area. If a macro name is longer than it's column width the
display of the name is truncated. If you typically use long names and
want the whole name displayed, you can widen the display field width here.
The widths are measured in units of characters.
{n,font:sys,pt:12,col:40}Hot-key field: \
{font:helv,pt:10,lmgn:60}The display field width of the Hot-key field.
{n,font:sys,pt:12,col:40}Macro name field: \
{font:helv,pt:10,lmgn:60}The display field width of the macro name field.
{n}{lmgn:20,n,font:sys,pt:12}Keystroke treatment while entering hot-keys: \
{font:helv,pt:10}When entering hot-keys into the Macro Information hot-key
edit field (see Macro Settings command) three keystrokes are treated specially
and cannot normally be entered as hot-keys. When set, these check-boxes
override the keystrokes special meaning and allows them to be entered.
The same applies to entering keystrokes for a
{fclr:fstd}Keyboard Input{fclr:fhelp} macro.
{n,font:sys,pt:12,col:40,fclr:fstd}Tab key \
{font:helv,pt:10,fclr:fhelp,lmgn:60}Normally advances the input focus to the next
dialog box control.
{n,font:sys,pt:12,col:40,fclr:fstd}Shift+Tab key \
{font:helv,pt:10,fclr:fhelp}Normally advances the input focus to the
previous dialog box control.
{n,font:sys,pt:12,col:40,fclr:fstd}Backspace key \
{font:helv,pt:10,fclr:fhelp}Normally clears the edit field identically
to clicking the
{font:sys,pt:12,fclr:fstd}Clear hot-key{font:helv,pt:10,fclr:fhelp} button.
{n}{n,font:sys,fclr:fstd,pt:12,lmgn:20}\
Minimize PM Assistant while pointing to window \
{font:helv,pt:10,fclr:fhelp}
When set, PM Assistant will minimize it's window when performing the
{font:sys,pt:12,fclr:fstd}Point{font:helv,pt:10,fclr:fhelp}
procedure in creating a {fclr:fstd}Position Window{fclr:fhelp} macro.
See the Position Window macro help topic for more information.
{n}{n,font:sys,fclr:fstd,pt:12}\
Minimize PM Assistant while recording MK macro \
{font:helv,pt:10,fclr:fhelp}
When set, PM Assistant will minimize it's window while recording a
{fclr:fstd}Mouse & Keyboard Input{fclr:fhelp} macro.
{n}{n,font:sys,pt:12}Restrict MK recording resolution to: \
{font:helv,pt:10}These settings restrict mouse movements when recording
{fclr:fstd}Mouse & Keyboard Input{fclr:fhelp} macros to the specified
resolution. Restricting the resolution allows you to create macros
on a computer with high resolution and run them on computers with
lower resolutions. The resolutions are:
{n,font:sys,pt:12,col:40,lmgn:60,fclr:fstd}640 x 480 \
{font:helv,pt:10,fclr:fhelp}Standard VGA resolution.
{n,font:sys,pt:12,col:40,fclr:fstd}720 x 540 \
{font:helv,pt:10,fclr:fhelp}Improved VGA resolution.
{n,font:sys,pt:12,col:40,fclr:fstd}800 x 600 \
{font:helv,pt:10,fclr:fhelp}Super VGA resolution.
{n}{n,lmgn:20,font:sys,pt:12}MK Recording dialog box hot-key: \
{font:helv,pt:10}Specifies a special hot-key used to bring the
{fclr:fstd}Mouse & Keyboard Input{fclr:fhelp} macro Recording dialog
box to the foreground. Hot-key access to the Recording dialog box can
be useful when recording macros to work with a maximized window which
hides the Recording dialog box. See the
{fclr:fstd}Mouse & Keyboard Input{fclr:fhelp} macro help topic for more
information.
{n}{n}Click the
{font:sys,pt:12,fclr:fstd}Save{font:helv,pt:10,fclr:fhelp} button to
save the new PM Assistant Options settings to the os2.ini file. If the
new settings are not saved they will be lost when you exit PM Assistant.
{n}{n}Click the
{font:sys,pt:12,fclr:fstd}Ok{font:helv,pt:10,fclr:fhelp} button to
accept, but not permanently save, the new settings.
{comment:-------------------------- Create --------------------------}
{sect:Create command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Create command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}Create{font:helv,pt:10,fclr:fhelp}
menu command creates a new macro (see also Macro Build for another way
to create macros).
{n}{n}A menu will appear listing the
six types of macros you can create.
{n}{n}The new macro will be inserted into the macro list just after the
currently selected macro.
{comment:-------------------------- Start Program macro --------------------}
{sect: Start Program macro}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Start Program macro
{n,pt:10,fclr:fhelp,col:60}\
A {fclr:fstd}Start Program{fclr:fhelp} type of macro starts a program
similarly to the Start Programs application.
A {fclr:fstd}Start Program{fclr:fhelp} macro has the following settings:
{n}{n,font:sys,pt:12}Command line: {font:helv,pt:10}\
The command line for the program to start.
{n}{n}To execute a command file (*.cmd), use
{n,font:sys,pt:12,fclr:fstd} cmd /c <filename>.cmd
{n,font:helv,pt:10,fclr:fhelp}as the command line.
{n}{n,font:sys,pt:12}Initial directory: {font:helv,pt:10}\
The directory in which the program is to be started. This would
typically be a directory containing the program's data files.
{n}{n,font:sys,pt:12}Program run method {font:helv,pt:10}\
After the command line is entered and the focus advanced to another field
(i.e. hit tab) a default
program run method is selected based on
the program specified. You can choose the run method if the program is
character based and can run in a window under PM or a full screen, or if
PM Assistant cannot determine a default run method.
The program run methods are:
{n,font:sys,pt:12,col:40,fclr:fstd}Program is a PM program. \
{font:helv,pt:10,fclr:fhelp,lmgn:60}\
Program is a windowing Presentation Manager program such as
PM Assistant.
{n,font:sys,pt:12,col:40,fclr:fstd}Run program in a PM text window. \
{font:helv,pt:10,fclr:fhelp}\
Program is a character based OS/2 program and is to run in a text window
(A text window looks like an OS/2 windowed command prompt).
{n,font:sys,pt:12,col:40,fclr:fstd}Run program in a full-screen. \
{font:helv,pt:10,fclr:fhelp}\
Program is a character based OS/2 program and is to run in a full-screen
(A full screen looks like an OS/2 full-screen command prompt).
{font:sys,pt:12,n}{n}Macro specifying initial position: \
{font:helv,pt:10}Can contain the name of a
{fclr:fstd}Position Window{fclr:fhelp} type of macro which
gives the position the program is to be started in.
{font:sys,pt:12,fclr:fstd,n}{n}Wait for program to end before continuing: \
{font:helv,pt:10,fclr:fhelp}If checked causes PM Assistant to suspend macro
execution until the program ends. Useful when the macro is a part of a
compound macro.
{n}{n}See also the Macro Build Start Programs Group command help topic
for how to import program information directly from the
Presentation Manager Start Programs application.
{comment:-------------------------- Position Window macro -------------------}
{sect: Position Window macro}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Position Window macro
{n,pt:10,fclr:fhelp,col:60}\
A {fclr:fstd}Position Window{fclr:fhelp} type of macro can move, re-size,
minimize, maximize, or bring to the foreground any program.
{n}{n}Before
creating a {fclr:fstd}Position Window{fclr:fhelp} macro the program to
position should be running and in the desired position. You indicate the
program to position by clicking the
{font:sys,pt:12,fclr:fstd}Point{font:helv,pt:10,fclr:fhelp}
button, then point and click on the program to position.
{n}{n}A {fclr:fstd}Position Window{fclr:fhelp} macro has the following
settings:
{font:sys,pt:12,fclr:fstd,n}{n}Size window: \
{font:helv,pt:10,fclr:fhelp}If checked the macro
re-sizes the indicated program to the indicated size.
{font:sys,pt:12,fclr:fstd,n}{n}Move window: \
{font:helv,pt:10,fclr:fhelp}If checked the macro
moves the indicated program to the indicated position.
{font:sys,pt:12,fclr:fstd,n}{n}Give window the input focus: \
{font:helv,pt:10,fclr:fhelp}\
If checked the macro gives the indicated program the input focus (brings
it to the foreground).
{font:sys,pt:12,fclr:fstd,n}{n}Restore window: \
{font:helv,pt:10,fclr:fhelp}\
If checked the macro restores the indicated program from a maximized or
minimized state.
{font:sys,pt:12,fclr:fstd,n}{n}Minimize window: \
{font:helv,pt:10,fclr:fhelp}\
If checked the macro minimizes the indicated program.
{font:sys,pt:12,fclr:fstd,n}{n}Maximize window: \
{font:helv,pt:10,fclr:fhelp}\
If checked the macro maximizes the indicated program.
{font:sys,pt:12,n}{n}If window does not exist \
{font:helv,pt:10}These settings control what PM Assistant does if the
indicated program to position does not exist when the macro is executed.
{n,font:sys,pt:12,col:40,fclr:fstd}First wait . . . seconds \
{font:helv,pt:10,fclr:fhelp,lmgn:60}If checked PM Assistant waits the
specified number of seconds for the program window to appear. This is
useful when a {fclr:fstd}Start Program{fclr:fhelp} macro refers to this
macro and the started program takes a while to draw it's window.
{n,font:sys,pt:12,col:40,fclr:fstd}Start program with macro: \
{font:helv,pt:10,fclr:fhelp}PM Assistant executes the named macro. The
named macro should then start the program.
{n,font:sys,pt:12,col:40,fclr:fstd}Give a warning. \
{font:helv,pt:10,fclr:fhelp}PM Assistant displays a message box explaining
that the indicated window does not exist.
{n,font:sys,pt:12,col:40,fclr:fstd}Continue without warning. \
{font:helv,pt:10,fclr:fhelp}PM Assistant continues without taking any
action.
{font:sys,pt:12,n,lmgn:20}{n}Window to position: \
{font:helv,pt:10}These settings control which window the macro positions.
{n,font:sys,pt:12,col:40,fclr:fstd}Indicated window: \
{font:helv,pt:10,fclr:fhelp,lmgn:60}The macro positions the window pointed
to when the {font:sys,pt:12,fclr:fstd}Point{font:helv,pt:10,fclr:fhelp}
button procedure is followed.
{n,font:sys,pt:12,col:40,fclr:fstd}Foreground window: \
{font:helv,pt:10,fclr:fhelp}The macro positions whatever window is in the
foreground at the time the macro is run.
{n,lmgn:20}{n}You can indicate a full-screen by pointing to the
icon representing the full-screen. This way you can create a macro
which brings a full-screen to the foreground.
{n}{n}See also the Macro Build Arrangement command for how to
build a set of {fclr:fstd}Position Window{fclr:fhelp} macros corresponding
to all current window positions.
{comment:-------------------------- Keyboard Input macro --------------------}
{sect: Keyboard Input macro}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Keyboard Input macro
{n,pt:10,fclr:fhelp,col:60}\
A {fclr:fstd}Keyboard Input{fclr:fhelp} type of macro can record keystrokes
and play them back to any PM program window or any full-screen.
{n}{n}A {fclr:fstd}Keyboard Input{fclr:fhelp} macro has the
following settings:
{font:sys,pt:12,n}{n}Keystrokes: \
{font:helv,pt:10}Enter the keystrokes to be played in this edit field.
This edit field behaves similarly to the
{font:sys,pt:12}Hot-key:{font:helv,pt:10} edit field of the Macro Information
dialog box in that it displays a textual representation for every keystroke,
even those which are non-printing keystrokes such as control-key combinations
or a space.
{n}{n}While entering the keystrokes typing a
backspace is the same as clicking the
{font:sys,pt:12,fclr:fstd} Clear keystrokes {font:helv,pt:10,fclr:fhelp}button,
it clears the entire Keystrokes sequence. See the Control Options command
help screen for information on how to record keystrokes containing a backspace.
{font:sys,pt:12,n}{n}Play keystrokes to: \
{font:helv,pt:10}These settings allow you to specify the window which receives
the keystrokes.
{n,font:sys,pt:12,col:40,fclr:fstd}Indicated window: \
{font:helv,pt:10,fclr:fhelp,lmgn:60}The macro plays the keystrokes to
the window pointed
to when the {font:sys,pt:12,fclr:fstd}Point{font:helv,pt:10,fclr:fhelp}
button procedure is followed.
The {font:sys,pt:12,fclr:fstd}Point{font:helv,pt:10,fclr:fhelp}
button procedure is identical to that used to indicate a window for a
{fclr:fstd}Position Window{fclr:fhelp} type of macro.
{n,font:sys,pt:12,col:40,fclr:fstd}Foreground window: \
{font:helv,pt:10,fclr:fhelp}The macro plays the keystrokes to whatever window
is in the foreground at the time the macro is run.
{comment:-------------------------- Compound macro --------------------}
{sect: Compound macro}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Compound macro
{n,pt:10,fclr:fhelp,col:60}\
A {fclr:fstd}Compound{fclr:fhelp} type of macro is used to combine several
macros. When the {fclr:fstd}Compound{fclr:fhelp}
macro is executed the contained macros are
executed sequentially.
{n}{n}A {fclr:fstd}Compound{fclr:fhelp} macro is displayed
in the macro list display area with it's body (the macros it combines)
indented and delineated by lines. You can expand and contract the display
of a {fclr:fstd}Compound{fclr:fhelp} macro's body - see the View Expand
command.
{n}{n}To insert macros into the body of a
{fclr:fstd}Compound{fclr:fhelp} macro, select the
{fclr:fstd}Compound{fclr:fhelp} macro, expand it's body, then create a
macro or insert one from the clipboard with the Edit Insert command. If
a {fclr:fstd}Compound{fclr:fhelp} macro's body is contracted, then macros
will be inserted {style:italic}after {style:normal}the
{fclr:fstd}Compound{fclr:fhelp} macro.
{n}{n}To abort the execution of a
{fclr:fstd}Compound{fclr:fhelp} macro, type Ctrl+C.
{n}{n}A {fclr:fstd}Compound{fclr:fhelp} macro has no settings besides
the initial Macro Information settings.
{comment:-------------------------- Group macro --------------------}
{sect: Group macro}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Group macro
{n,pt:10,fclr:fhelp,col:60}\
A {fclr:fstd}Group{fclr:fhelp} type of macro behaves the same as a
{fclr:fstd}Compound{fclr:fhelp} macro except that they cannot be executed.
{fclr:fstd}Group{fclr:fhelp} macros are used to gather similar macros
that are not intended to be executed sequentially as one.
{n}{n}Gathering similar macros into a
{fclr:fstd}Group{fclr:fhelp} macro eases viewing of macros because the
{fclr:fstd}Group{fclr:fhelp} macro's body is visually isolated, and
the body can be expanded and contracted - see the View Expand command.
{n}{n}Editing of the macro list is
made easier because the entire group of macros can be cut/paste in one
operation - see the Edit commands help topic.
{comment:-------------------------- Message macro --------------------}
{sect: Message macro}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Message macro
{n,pt:10,fclr:fhelp,col:60}\
A {fclr:fstd}Message{fclr:fhelp} type of macro displays a message when executed.
{fclr:fstd}Message{fclr:fhelp} macros are used in several ways:{n}
{col:40}- To display prompts or other information during the execution of a complex
compound macro.{n}
{col:40}- To document a group of macros, a compound macro, or a macro file.
Such macros are in the sample macro file a_sample.pma and have the name
"Information."{n}
{col:40}- To display reminders at certain times. Such macros are scheduled to appear
using the Macro Date & Time menu command.{n}{n}
{fclr:fstd}Message{fclr:fhelp} macros do not have hot-keys because it is not generally
useful to execute a single message macro in response to a hot-key being pressed. If
you wish to execute a message macro with a hot-key, put it in a compound macro and
assign a hot-key to that compound macro.
{comment:-------------- Macro Build Arrangement command--------------}
{sect:Macro Build Arrangement command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Macro Build Arrangement command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}Macro Build Arrangement{font:helv,pt:10,fclr:fhelp}
command builds a {fclr:fstd}Compound{fclr:fhelp} macro made up of
{fclr:fstd}Position Window{fclr:fhelp}
macros. A {fclr:fstd}Position Window{fclr:fhelp} macro is created to
move each window on the desktop to it's current location.
{n}{n}In this way you can save the current desktop arrangement and
restore it later by executing the built macro.
{n}{n}After choosing the
{font:sys,pt:12,fclr:fstd}Macro Build Arrangement{font:helv,pt:10,fclr:fhelp}
command, you enter the settings for the
{fclr:fstd}Compound{fclr:fhelp} macro to build.
After you've entered the settings the
{fclr:fstd}Position Window{fclr:fhelp} macros are built.
{comment:-------------------------- View Expand command -------------------}
{sect:View Expand command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
View Expand command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}View Expand{font:helv,pt:10,fclr:fhelp}
command expands or collapses (toggles) the display of the
currently selected {fclr:fstd}Compound{fclr:fhelp} or
{fclr:fstd}Group{fclr:fhelp} macro's body.
{n}{n}You can also expand or collapse the display of a
{fclr:fstd}Compound{fclr:fhelp} or
{fclr:fstd}Group{fclr:fhelp} macro's body by clicking on the
{fclr:fstd}(+)/(-){fclr:fhelp} symbol displayed in front of the macro's name.
A {fclr:fstd}(+){fclr:fhelp} is displayed
if the macro is currently collapsed, a {fclr:fstd}(-){fclr:fhelp}
if it is currently expanded.
{comment:-------------------------- View Expand All command ----------------}
{sect:View Expand All command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
View Expand All command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}View Expand All{font:helv,pt:10,fclr:fhelp}
command expands the display of all
{fclr:fstd}Compound{fclr:fhelp} and
{fclr:fstd}Group{fclr:fhelp} macros' bodies. A check mark appears
next to the
{font:sys,pt:12,fclr:fstd}View Expand All{font:helv,pt:10,fclr:fhelp}
menu item. This command is useful if you want to quickly view all macros.
{n}{n}Choosing the
{font:sys,pt:12,fclr:fstd}View Expand All{font:helv,pt:10,fclr:fhelp}
command again restores the display of all
{fclr:fstd}Compound{fclr:fhelp} and
{fclr:fstd}Group{fclr:fhelp} macros' bodies to their previous state.
The check mark next to the
{font:sys,pt:12,fclr:fstd}View Expand All{font:helv,pt:10,fclr:fhelp}
menu item is removed.
{comment:-------------------------- View Find Macro command -----------------}
{sect:View Find Macro command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
View Find Macro command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}View Find Macro{font:helv,pt:10,fclr:fhelp}
command searches for a macro based on the strings in
the Macro Information settings. The search dialog box requests the
following information:
{n}{n,font:sys,pt:12}Search string: \
{font:helv,pt:10}Enter the string to search for.
{n}{n,font:sys,pt:12}Macro strings to search: \
{font:helv,pt:10}Specifies the Macro Information string settings to search
for a matching string. You can choose any combination of the three settings
{font:sys,pt:12,fclr:fstd}Name{font:helv,pt:10,fclr:fhelp},
{font:sys,pt:12,fclr:fstd}Comment{font:helv,pt:10,fclr:fhelp}, and
{font:sys,pt:12,fclr:fstd}Hot-key{font:helv,pt:10,fclr:fhelp}.
{n}{n,font:sys,pt:12}Case sensitivity: \
{font:helv,pt:10}Specifies whether to use a
{font:sys,pt:12,fclr:fstd}Case sensitive{font:helv,pt:10,fclr:fhelp} or a
{font:sys,pt:12,fclr:fstd}Case insensitive{font:helv,pt:10,fclr:fhelp}
string match.
{n}{n}Strings need not match starting with the first character of the Macro
Information setting. For example, if you have a macro named 'One Macro'
and search for the string 'Macro', the macro 'One Macro' would be found.
The search starts with the macro following the currently selected macro. To
search all macros select the first macro in the macro list (type the Home
key).
To initiate the search click the
{font:sys,pt:12,fclr:fstd}Search{font:helv,pt:10,fclr:fhelp} button.
{n}{n}The Status/Help line will indicate the success or failure of the search.
{comment:-------------------------- View Find Next command -----------------}
{sect:View Find Next command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
View Find Next command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}View Find Next{font:helv,pt:10,fclr:fhelp}
command searches for a macro based on the same criteria
used in the last
{font:sys,pt:12,fclr:fstd}View Find Macro{font:helv,pt:10,fclr:fhelp}
command. The search starts with the
macro following the currently selected macro.
{n}{n}The Status/Help line will indicate the success or failure of the search.
{comment:-------------------------- View Status/Help Line command -----------}
{sect:View Status/Help Line command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
View Status/Help Line command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}View Status/Help Line{font:helv,pt:10,fclr:fhelp}
command removes or restores (toggles) the
Status/Help line at the bottom of the PM Assistant display.
{n}{n}Removing the Status/Help line leaves more room to display the
macro list.
{comment:-------------------------- View Memory Stats command -----------}
{sect:View Memory Stats command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
View Memory Stats command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}View Memory Stats{font:helv,pt:10,fclr:fhelp}
command displays statistics about the memory requirements
of the current macro list (including any macros on the macro clipboard)
on the Status/Help line. The statistics message reports two values:
{lmgn:50}
{n}{n,fclr:fstd,col:20}Macro list in memory: <number> bytes
{n,fclr:fhelp}- This portion of the message reports how many bytes of computer memory is
required to store the macro list.
{n}{n,fclr:fstd,col:20}in a file: <number> bytes
{n,fclr:fhelp}- This portion of the message reports how many bytes of disk space
is required to store the macro list in a file.
{comment:---------------------- Control Invoke commands ----------------}
{sect:Control Invoke commands}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Control Invoke commands
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}Control Invoke{font:helv,pt:10,fclr:fhelp}
commands allow you to invoke Password Protection,
Screen Saver, or both. Choose which to invoke from the
{font:sys,pt:12,fclr:fstd}Control Invoke{font:helv,pt:10,fclr:fhelp}
submenu.
{n}{n}Invoking Password Protection makes your computer inaccessible until
the correct password is entered. PM Assistant can be configured to invoke
Password Protection automatically after a period disuse. See the Control
Password Protection command for information on setting the password and
automatic invocation features.
{n}{n}Invoking Screen Saver blanks your computer screen to prevent
image burn-in. PM Assistant can be configured to invoke
Screen Saver automatically after a period disuse. See the Control
Screen Saver command for information on setting the screen saver feature.
{comment:------------------------ Control Password command ---------------}
{sect:Control Password command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Control Password command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}Control Password{font:helv,pt:10,fclr:fhelp}
command lets you change the settings of the Password
Protection feature. When invoked, Password Protection makes your computer
inaccessible until the correct password is entered.
Password Protection has the following settings:
{n}{n,font:sys,pt:12}Automatic invocation: \
{font:helv,pt:10}These settings control how PM Assistant automatically
invokes Password Protection after a period of disuse.
{n,font:sys,pt:12,col:40}Time delay: \
{font:helv,pt:10,lmgn:60}Specifies the length of disuse before Password
Protection is automatically invoked. Enter the hours:minutes:seconds
of the delay in the three edit fields.
{n,font:sys,pt:12,col:40,fclr:fstd}Enabled \
{font:helv,pt:10,fclr:fhelp}Enables Password Protection automatic
invocation. When enabled, a check mark appears next to the Control Password
menu command.
{n,font:sys,pt:12,col:40,fclr:fstd}Disabled \
{font:helv,pt:10,fclr:fhelp}Disables Password Protection automatic
invocation. You can still invoke Password Protection with the
{font:sys,pt:12,fclr:fstd}Control Invoke Password Protection{font:helv,pt:10,fclr:fhelp}
command.
{lmgn:20,n}{n}Click the
{font:sys,pt:12,fclr:fstd}Password{font:helv,pt:10,fclr:fhelp} button to
set the password. You will be presented with the Password Entry prompt.
Type your new password then type Enter. You will be asked to enter your
new password a second time to confirm it. You will be warned if your second
entry does not match the first and the password will not be changed.
{n}{n}Click the
{font:sys,pt:12,fclr:fstd}Save{font:helv,pt:10,fclr:fhelp} button to
save the new Password Protection settings to the os2.ini file. If the
new settings are not saved they will be lost when you exit PM Assistant.
{n}{n}Click the
{font:sys,pt:12,fclr:fstd}Ok{font:helv,pt:10,fclr:fhelp} button to
accept, but not permanently save, the new settings.
{comment:------------------------ Control Screen Saver command ---------------}
{sect:Control Screen Saver command}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Control Screen Saver command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}Control Screen Saver{font:helv,pt:10,fclr:fhelp}
command lets you change the settings of the Screen
Saver feature. When invoked, Screen Saver blanks the screen preventing image
burn-in. Screen Saver has the following settings:
{n}{n,font:sys,pt:12}Automatic invocation: \
{font:helv,pt:10}These settings control how PM Assistant automatically
invokes Screen Saver after a period of disuse.
{n,font:sys,pt:12,col:40}Time delay: \
{font:helv,pt:10,lmgn:60}Specifies the length of disuse before Screen Saver
is automatically invoked. Enter the hours:minutes:seconds
of the delay in the three edit fields.
{n,font:sys,pt:12,col:40,fclr:fstd}Enabled \
{font:helv,pt:10,fclr:fhelp,lmgn:60}Enables Screen Saver automatic
invocation. When enabled, a check mark appears next to the Control Screen
Saver menu command.
{n,font:sys,pt:12,col:40,fclr:fstd}Disabled \
{font:helv,pt:10,fclr:fhelp,lmgn:60}Disables Screen Saver automatic
invocation. You can still invoke Screen Saver with the
{font:sys,pt:12,fclr:fstd}Control Invoke Screen Saver{font:helv,pt:10,fclr:fhelp}
command.
{lmgn:20,n}{n}
{font:sys,pt:12}Text to display: \
{font:helv,pt:10}Enter a phrase to display in this edit box. The phase is
displayed in varying positions and colors while Screen Saver is invoked.
One phase might be "Computer is on" to remind you that although the screen
is blank, the computer is on.
{n}{n}Click the
{font:sys,pt:12,fclr:fstd}Save{font:helv,pt:10,fclr:fhelp} button to
save the new Screen Saver settings to the os2.ini file. If the
new settings are not saved they will be lost when you exit PM Assistant.
{n}{n}Click the
{font:sys,pt:12,fclr:fstd}Ok{font:helv,pt:10,fclr:fhelp} button to
accept, but not permanently save, the new settings.
{comment: --------------- Supply parameters dlg box ----------------------}
{sect:Supply parameters box}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Supply parameters dialog box
{n,pt:10,fclr:fhelp,col:60}\
The Supply Parameters dialog box appears when you execute a Start Program
macro which specifies a question mark (?) as the only parameter to the
program to execute. Fill in the parameters you wish to pass to the program
in the
{font:sys,fclr:fstd,pt:12}Parameters{font:helv,pt:10,fclr:fhelp}
entry field.
{comment:-------------------------- Compound Macro Settings--------------------------}
{sect:Compound macro box}\
{bclr:bhelp}\
{lmgn:20,rmgn:20,font:helv,pt:14,fclr:fstd}\
Macro Settings command
{n,pt:10,fclr:fhelp,col:60}\
The
{font:sys,pt:12,fclr:fstd}Compound Macro{font:helv,pt:10,fclr:fhelp}
dialog box has the same fields as the standard Macro Settings dialog box with
the addition of a
{font:sys,fclr:fstd,pt:12}Delay between macros, in seconds{font:helv,pt:10,fclr:fhelp}
entry field. When executed, the compound macro waits the specified number of
seconds before executing each macro it contains. This is useful for viewing the
exact behavior of an executing macro, and for inserting delays required for other
programs to finish processing commands. The delay can be a fraction of a second
such as .5 for half a second.