Command Post Version 6.2 The Windows Environment Command Post is a MS Windows application designed to allow users to easily personalize the MS-DOS Executive control window. Command Post allows users to easily add menu and dropdown menu items to the main MS-DOS Executive menu bar, and to execute desired applications when a menu item is selected. Command Post also provides file management features and a directory tree. A number of additional features, such as screen blanking and window arranging, are also made available. This version of Command Post requires Microsoft Windows, versions 2.03 or newer for proper operation. It is completely incompatible with the old Windows 1.x software. Information in this document is subject to change without notice and does not represent a commitment of any kind from Wilson WindowWare. The software described in this document is distributed free or at minimal charge for evaluation only. Users of this software are to license this software according to the instructions given in this document. Copies of this software may be made only in accordance with instructions given in this document. Copyright Morrie Wilson, 1988-1989 Command Post is a trademark of Wilson WindowWare. Microsoft and MS-DOS are registered trademarks and Windows is a trademark of Microsoft Corporation. PageMaker is a trademark of Aldus Corporation. In*A*Vision and Designer are trademarks of MICROGRAFX, Inc. Command Post 6.2 2 Table of Contents Licensing and Duplication Information Duplication Restrictions / Other Information... 5 General Licensing Information.................. 6 Payment with Order Licensing Information......................... 7 Purchase Orders Requiring Billing Licensing Information......................... 8 International Orders........................... 9 Command Post An Introduction............................... 10 Installing Command Post....................... 11 Using Command Post Getting Started with Command Post............. 13 Command Post Commands......................... 14 The File Menu Item Extensions.............. 15 The Windows Menu Item...................... 16 The CmdPost Menu Item...................... 18 The Option Selection Dialog Box............ 19 System Menu Extensions........................ 20 Command Post HotKey........................... 21 Screen Blanking............................... 22 Time and Date Display......................... 23 Directory Tree................................ 24 Command Post 6.2 3 Command Post Menus Making Personalized Menus..................... 25 A Simple Sample Menu.......................... 27 An Ample Sample Menu.......................... 28 Command Post Keyboard Interface............... 29 Advanced Menus................................ 30 Command Post File Name Insertion.............. 31 Command Post Prompter Details................. 34 Notes Notes - Program Not in Path................... 35 Notes - Reloading Menus....................... 36 Notes - Automagic Directory Updates........... 37 Notes - MS-DOS View Menu selections........... 38 Notes - Exiting Command Post in Windows....... 39 Notes - System Information.................... 40 Notes - Secret Parameters..................... 41 Appendices Appendix A - Special Thanks................... 42 Appendix B - Command Post Version Information. 43 Appendix C - Other Window Applications........ 46 Appendix D - Command Post Online Support...... 47 Appendix E - Patches for Non-English Windows.. 48 Appendix F - Command Post Licensing Reminders. 51 Command Post 6.2 4 Licensing and Duplication Information Duplication Restrictions / Other Information Command Post is a shareware product. It may be freely copied and distributed for evaluation as long as four basic rules are followed. These rules are: 1) The program and this documentation may not be modified in any way. 2) A copy of this documentation is provided with the program. 3) No charge, other than a "media and handling" charge, (not to exceed $8.00) is made. 4) Users of the program purchase a license for its use. One license per usable copy of Command Post is required. Archive and backup copies do not count. Please note that if you purchased a disk containing this software from a public domain/shareware software distributor you have paid the media and handling charges as permitted above. You have not purchased a license. Purchasing a license is required for continued use. The accuracy of the information supplied here and the fitness of the Command Post program for any purpose may change without notice, and should not be construed as any kind of a commitment. No responsibility is assumed for any errors or problems that may be encountered with use of this product. There are no warranties whatsoever associated with this product. Command Post 6.2 5 General Licensing Information Command Post must be licensed to be used other than for an initial evaluation. Two licensing rates are available, as given below: Rates for payment with order: $20 Single user license $ 5 Command Post software on diskette. Please specify 5 1/4" or 3 1/2" diskette. $10 Printed documentation Rates for Purchase Orders requiring billing, or for purchase via third party vendors: $50 Includes single user licensed diskettes (5 1/4" and 3 1/2"), and printed documentation. Command Post 6.2 6 Payment with Order Licensing Information Under the "Payment with Order" plan we accept personal and business checks, along with Visa and MasterCard charges. Checks must be mailed, while we can accept Visa and MasterCard purchases over the phone. MailOrders For mailorder purchases, enclose the following items in an envelope and mail to the address given below: Enclose: 1) List of items desired --license(s), disk(s), number of copies of documentation 2) Payment (either check or charge card info). For charge card orders, include card number, expiration date and card billing address. 3) Name and address Mail to: Wilson WindowWare 3377 59th SW Seattle WA 98116 Phone Orders For phone order purchases we will need your card number, expiration date, card billing address, and desired purchases. Our phone lines are open from 9:00 AM to 9:00 PM Pacific Time. East Coast residents will need to wait until after Noon Eastern Time before placing their calls. Our phone number is (206) 937-9335. Licensing materials will generally be sent to you within 24 hours. Command Post 6.2 7 Purchase Orders Requiring Billing Licensing Information Purchase orders are subject to acceptance. We generally reject purchase order requests that obligate us to your company's terms and conditions. As stated above there are no warranties whatsoever associated with the Command Post software product, and we are not responsible for its performance. You are the sole judge of the product's effectiveness and suitability for your application. To order Command Post, enclose the following items in an envelope and mail to the address given below: Enclose: 1) Purchase order stating: Number of copies Shipping address Billing address 2) Name, address and phone number of a knowledgeable individual whom we may contact should any question about this order arise. Mail to: Wilson WindowWare 3377 59th SW Seattle WA 98116 (206) 937-9335 Command Post 6.2 8 International Orders Wilson WindowWare recognizes the difficulties our international customers face in presenting payment for our products. These difficulties include excessive fees charged for international money orders, various postal delays, and currency conversion problems of various sorts. For this reason we recommend payment via MasterCard (EuroCard) or Visa. The credit companies will perform any necessary currency conversions, and eliminate possibility of the loss of the funds by the postal services. Although we do accept both mail-order and phone-order purchases, our phone operators generally only speak English, and are therefore limited in the amount of non- English assistance they can provide. In addition, because of the increased postal costs, we must charge additional postal fees for international orders. We mail all goods via airmail, thus avoiding unnecessarily long waits. The additional fees are as follows: Item Surcharge License None Disk $2.00 Manual $8.00 International users not running the English or the International English version of Microsoft Windows may need to make special entries in the WIN.INI file. Please refer to Appendix E for more information. Foreign language versions of Command Post may be available. Please inquire if you are interested. Command Post 6.2 9 Command Post An Introduction Command Post is a Microsoft Windows application designed to allow users to easily personalize the MS-DOS Executive control window. Command Post also extends the functionality of the Executive window by adding a number of additional features, such as file management and a directory tree. Command Post allows users to easily add any number of Menu and Submenu items to the main MS-DOS Executive menu bar, and to execute one or more desired applications when the added menu items are selected. Command Post can take a high-lighted file name from its directory display and use the file name as a parameter for your application. Command Post can be instructed to prompt users for parameters for their applications. You can supply the prompting question, and even a default answer if you choose. Command Post menus are created using the Notepad Editor, or with any other text editor that can save a plain ASCII file. Special menu editors are not required. The Command Post menu file has an easy and straightforward syntax, and can be re-loaded into Command Post after modification. Command Post's window manager allows the user to automatically stack or arrange windows in a variety of formats. Command Post also provides for screen blanking and a special time and date display which gives you quick access back to Command Post. The Command Post file management features are enabled when there are two Command Post windows open. Files may be moved or copied from one Command Post window to the other. The Command Post directory tree may be used to navigate the directories and set the Command Post windows accordingly (via clicking the desired directory with either the left or right mouse buttons). Command Post 6.2 10 Installing Command Post Command Post is easily installed. Simply copy the following four files to your windows directory (usually either \WIN, \WINDOWS, or \WIN386). Other directories may be used, but whatever directory is chosen, it MUST be defined in the MS- DOS PATH statement (which is usually in your autoexec.bat file). CMDPOST.EXE CMDLIB.EXE CMDTREE.EXE CMDPOST.MNU <--- Do not copy this file if you are updating from a previous version. If you do not have a COMMAND.PIF file, also copy the COMMAND.286 or the COMMAND.386 file (depending on what version of Windows you are running). After copying the desired file, rename it to COMMAND.PIF. A COMMAND.PIF is required for the DOS C:> menu item under the CmdPost menu to work. COMMAND.286.\ > Copy one of these and rename to COMMAND.386 / COMMAND.PIF CMDPOST.EXE is the Command Post application file. When it is invoked, as discussed in a following section, it attempts to locate and load the Command Post menu file, CMDPOST.MNU. CMDLIB.EXE is not meant to be executed by the user. It contains window library routines that are invoked by CMDPOST.EXE. CMDTREE.EXE is the Command Post Tree. It may be executed via the Directory Tree menu item, be placed into a user- defined Command Post menu, or simply be double-clicked to start the Tree. The sample CMDPOST.MNU file supplied with Command Post will get you started defining your very own Command Post menus. You WILL need to modify the CMDPOST.MNU file before it is fully functional on your system. Command Post 6.2 11 Installing Command Post (continued) Command Post, of course, assumes that your system is properly configured to run Windows. Of special interest is the CONFIG.SYS file, which is used to set some initial DOS parameters while the system is booting up. It is recommended that your CONFIG.SYS file contain the following items. The values given for these items are a minimum, and larger values may be used as your other applications warrant. FILES=25 BUFFERS=20 Command Post 6.2 12 Using Command Post Getting Started with Command Post Command Post may be invoked with any of the methods that follow: 1) Via the MS-DOS menu in Windows. If Command Post is invoked this way, it will take over the MS-DOS Executive window, modify the menu bar, install your personalized menu items, and then allow you to proceed. 2) You may modify your WIN.INI file, adding CMDPOST.EXE to either the RUN= or the LOAD= sections. This will automatically start Command Post whenever you start Windows. Special Note: Command Post does not follow the standard definitions of the RUN= and LOAD= lines. Only by having the RUN= line blank can Command Post be started as a window, otherwise Command Post will be started as an Icon. 3) You may also type WIN CMDPOST at the MS-DOS prompt. Command Post will be started as an icon. Initially, when you start Command Post you will see a simple extension to the MS-DOS Executive window, as defined by the CMDPOST.MNU file that is shipped with Command Post. This simple menu allows you access to the desktop accessories and other applications shipped with the standard version of Microsoft Windows. After reading the section on defining your own menus, you can edit CMDPOST.MNU to add your own menu items. You may have one or two Command Post windows at one time. Each Command Post Window may be identified by the number of "<...>" surrounding the window title. For example: ... window 1, unlicensed <> ... a window 2 possibility Command Post 6.2 13 Command Post Commands Command Post adds a number of main menus to the standard MS- DOS menus. It also slightly modifies the MS-DOS File dropdown menu. Command Post modifies the MS-DOS File dropdown menu by installing the Move, Directory Tree and the Exit Command Post menu items. Command Post adds two of its own main menus onto the normal set of MS-DOS menus. These menu are Windows and CmdPost. In addition any (reasonable) number of user-defined menu items may be added. The Windows menuitem, as described later, assists the user in locating and viewing windows. From it you can locate all the application windows, and re-arrange up to twelve application windows. The CmdPost menu item, as described later, contains the Command Post control functions, and Windows accessories that support the control functions (such as Clipboard and the Control Panel). The user menus are one of the reasons for Command Post's existence. User menus may be easily added to the normal set of MS-DOS menus through a file named CMDPOST.MNU. These menus can change directories and start applications as defined by the user. Command Post 6.2 14 The File Menu Item Extensions Command Post adds or modifies a few menuitems on the File dropdown menu (as compared to the Standard MS-DOS). The Directory Tree item is added, and is used to access a directory tree. See the separate section on the Directory Tree for more information. What was simply Exit is now Exit Command Post. This item allows the user to exit the Command Post environment and remain in Windows. This may be useful in running memory intensive applications (e.g. Aldus Pagemaker) on systems with limited memory. The Copy... menuitem has been modified, while the Move... menuitem has been added. When only one Command Post window is open, Copy... works just like it does in the MS-DOS Executive window, and Move... simply returns a short reminder that you need two Command Post windows open for a Move... When two Command Post windows are open, Copy... and Move... will move the highlighted files to the disk and directory pointed to by the other Command Post window. To start up a second Command Post window, merely select the Command Post menuitem in the CmdPost dropdown menu. To highlight more than one file in a directory for a copy or a move, hold the shift key down while clicking files with the mouse, or use the arrow keys and the spacebar (while holding the shift key down) to select the desired files. IMPORTANT LIMITATION There is an IMPORTANT LIMITATION on the Command Post Move and Copy utilities. For a file to be copied or moved to the other Command Post window, the file not only must be highlighted, but it MUST BE VISIBLE. It may not be scrolled out of the directory window. Files not actually visible will not be copied or moved. Command Post 6.2 15 The Windows Menu Item The Windows menu item is used to navigate through your various windows. There are two types of menuitems shown on the Windows submenu. The eight on the left are normal, permanent menu items, and are used to arrange your open windows. The arrange commands will arrange up to 12 open windows. You have your choice of including Command Post in the arrangement, or excluding it and causing it to be minimized. To the right of the first eight menu items will appear a list of top-level application windows that can be jumped to by merely selecting the menu item from the list. The item may be selected either with a mouse or by the letter code provided. Command Post will immediately transfer you to that window. These commands are particularly handy for handling overlapped windows because a small window can easily get lost beneath a multitude of other windows and become difficult to find. Note: Command Post will not arrange minimized (iconized) windows. Be sure that the windows you want arranged are not minimized. Command Post will arrange the windows with the most recently used window in the top left hand corner (or at the top of the stack), followed by the remaining windows, in the order that they were last used. Command Post 6.2 16 The Windows Menu Item (continued) The Windows menu item has eight normal dropdown menu items, as follows: Stack This item will arrange the open windows into a stack, with the window caption lines peeking out from behind the previous window. Arrange This item will arrange windows in a Command Post defined pattern. Arrange Rows This item will arrange windows into rows. Enabled for 2 to 4 windows. Arrange Columns This item will arrange windows into columns. Enabled for 2 or 3 windows. Stack w/o CP Arrange w/o CP Arrange Rows w/o CP Arrange Cols w/o CP Same as above, except that Command Post will be minimized instead of being included in the arrangement. Following the normal menu items is a list of all named top-level windows. Selecting a member of this list will transfer control to the selected window. Command Post 6.2 17 The Windows Menu Item (continued) The CmdPost menu item has nine dropdown menu items, as discussed below: Command Post Starts another Command Post Window, primarily for file management. Control Panel Starts the Control Panel Window Clipboard Starts the Clipboard Window DOS C:> Starts COMMAND.COM, via COMMAND.PIF, thus providing a DOS prompt. Use the EXIT command to close the window. Confirm Selections This item is a toggle. If it is checked, then any selection from the user's personalized menu will appear in a dialog box. The user may modify any of the fields and then run it. Option... Selection of this menu item will cause an option dialog box to be displayed. See Option Selection Dialog box section below. Reload CmdPost Menus This command is used to reload the Command Post menu after modifying CMDPOST.MNU with an editor. System Information Displays Windows version, DOS version, LIM Driver version and various interesting memory usage numbers. About Command Post... To find out About Command Post. Command Post 6.2 18 The Option Selection Dialog Box The Option Selection Dialog box allows specification of the Command Post options. These are: 1) The automatic directory display update. When checked,the MS-DOS directory display will be updated when Command Post becomes active. If not checked, the user must select one of the Disk Drive icons in order to update the directory display. 2) Return to original directory. When checked, menu selections will not change the current directory displayed in the MS-DOS/Command Post window, unless a directory change only menuitem was selected (as when the application line in the menu is an indented period). 3) Blanked Screen [Press Any Key] box. The small box on a blanked display may be disabled with this item. 4) Align dual Command Post windows side by side box. When checked this item will align the Command Post windows in columns when a second Command Post is started. 5) Save Command Post window position. If this box is checked, Command Post will record the current Command Post window size and position, and set the Command Post window to this size and position on future startups. 6) Screen Blanking Delay Time. Command Post will blank the screen after a period of inactivity (no key hits or mouse movement). Specify time desired before screen blanking occurs. Enter zero to disable screen blanking. 7) Window Personalization. In licensed copies of Command Post, a short (30 chars) text string may be appended to the Command Post window title. The following window title is possible: Command Post 6.2 19 System Menu Extensions One item has been added to the system (ALT-SPACEBAR) menu. It is the End Windows Session command. The End Windows Session menu item is identical to the End Session menu item in the MS-DOS Executive Special menu. They both first ask the user to confirm the request, and if confirmed, then all running applications are given a chance to indicate as to whether or not this is a good idea. This is what happens, for example, when editors (or other programs) with unsaved work ask the user to indicate whether the latest changes should be saved or discarded when a request is made to close down Windows. Command Post 6.2 20 Command Post HotKey The Command Post HotKey, CONTROL-SHIFT-ESCAPE, will transfer control to Command Post from any other application window. In addition, doubleclicking the Command Post clock display with the left mouse button will also transfer control to Command Post. There are some applications inside of which the Command Post HotKey does not function. These applications include old (non-window) applications which grab the keyboard interrupts for themselves, rather than letting DOS pass keyboard info to them, and, for Windows/386 users, applications running in DOS partitions. Note: The HotKey is disabled if you run the Microsoft Excel tutorial or feature guide. If you try using the HotKey when in the feature guide or the tutorial, Command Post will respond with a beep and not activate itself. Command Post 6.2 21 Screen Blanking Command Post has a built in screen blanker. After a specified period of inactivity, Command Post will blank the screen. If enabled, via the CmdPost Options... box, a small display of the current personalization text, if any, and a "Press any key to continue" message will move about the screen. To return to Windows simply press any key or move the mouse. The screen will not blank if an "Old Application" is currently in control. The screen blanking may be enabled and disabled, or the delay period may be modified using the Options... menu item under the CmdPost menu. Command Post 6.2 22 Time and Date Display Command Post maintains a small window, located initially in the lower right corner of the display. This window has three different displays. They are: Command Post Version Number Day, Date and Time (in seconds) Day, Date and Time (in minutes) The display may be changed by clicking it with the right mouse button, or (only for users currently uninfested by rodents) by selecting the CmdPost Clock from the Command Post Windows menu and typing characters at it. If the date/time display is counting time in seconds, Command Post will attempt to maintain the window on the surface of the screen at all times. If the display is not counting in seconds, the display window will behave like most other windows and will disappear behind windows that move in front of it. The display may be moved by either dragging it with the left mouse button or using Alt-F7 to get the standard Windows Move Cursor, and using the arrow keys followed by an Enter. Doubleclicking the display with the left mouse button will cause control to be transferred to the Command Post window, much in the same manner as the Command Post HotKey. Doubleclicking the display with the right mouse button will cause the Command Post System Information box to appear. Command Post 6.2 23 Directory Tree The Command Post Directory Tree is started via the Directory Tree menuitem in the File dropdown menu. After being selected, there is a short pause while the tree of the currently logged disk is analyzed. The directory tree then appears. To obtain the tree of other disks, select the desired disk from the Disk menu. When the Disk menuitem is selected, a dropdown menu displays all the currently online disk drives. To see the files contained within a given sub-directory, simply click the desired directory with the left mouse button. The directory display of the first Command Post window will be updated to show the files. If you click a subdirectory with the right mouse button, the files contained in it will be displayed in the second Command Post window. If a second window is not yet open, clicking the right mouse button will open one. If you do not have a mouse, just use the arrow keys to move the highlight to the desired directory, and hit Enter to show the files in the first Command Post window. To show the files in the second Command Post window, hold down the shift key before hitting Enter. Command Post 6.2 24 Command Post Menus Making Personalized Menus Command Post uses a file called CMDPOST.MNU to build personalized menus. The CMDPOST.MNU file normally resides in your Windows directory next to the CMDPOST.EXE file. In order to modify the default menu shipped with Command Post, or to modify the menu as requirements change, simply edit the CMDPOST.MNU file with the Notepad editor (or any other plain ASCII editor). Take a moment to examine the contents of CMDPOST.MNU. Its structure is actually very simple. There are only 4 types of entries. These types are: 1) Comments. Blank lines and any line with a single quote mark in the first column (col 1) is considered a comment and is ignored by Command Post. 2) The Main Menu Titles. Main menu titles are the menu headings displayed on the menu bar. These main menu titles MUST start in the first column (col 1). Although Command Post allows these main menu titles to be rather long, it is advised, for aesthetic reasons, to keep the main menu titles short. One word should be sufficient. 3) The Dropdown Menu Items. Dropdown menu items comprise the menus that drop down every time a main menu title is selected. The dropdown menu items MUST start in the second column (col 2) and may be long, although, for aesthetic reasons again, should be limited to about 25 characters or less. Note that for dropdown menu itmes, the first character of the line MUST be a space, with the first letter of the dropdown menu item starting in column 2. Command Post 6.2 25 Making Personalized Menus (Continued) 4) The menu action lines. For each dropdown menu item, there are one or more pairs of menu action lines. The first line of each pair specifies the initial directory (or path), and the second line specifies the application and any parameters that may be required. These lines MUST be preceded by at least TWO SPACES, or a TAB character. (All these spaces, or lack of them, are used by Command Post to tell these various kinds of lines apart.) Initial Directory Specification: The first line of each pair specifies the initial directory, and may be preceded by a disk drive identifier. If the currently logged directory is desired, use a period "." for the directory specification. Application Specification: The second line of each pair is used to specify the desired application, and any parameters that may be desired. This line can get pretty fancy, but we will keep it simple for a bit more. One thing to remember though, is that the application's name MUST include the three letter suffix (.EXE, .COM, .PIF, or .BAT). Note: If the application specified is merely a period, this indicates to Command Post that all the selection is to do is to change the directory, rather than actually start up an application. The directory display of the Command Post window will change to the new disk and directory specified in the directory line, even if the "Return to original directory" box was checked in the Options... dialog box. Command Post 6.2 26 A Simple Sample Menu Now that we got the basic menu formats defined, lets look at a sample menu to see what all these specifications really mean. Examine the simple menu below: Desktop Get Clock and Calendar . clock.exe . calendar.exe Get Cardfile . cardfile.exe Word Processing Get Notepad Editor . notepad.exe Get Windows Write . write.exe This simple menu has two main menu headings, "Desktop" and "Word Processing". If the user selects the "Desktop" menu heading, a dropdown menu containing two items "Get Clock and Calendar" and "Get Cardfile" will appear. On the other hand, if the user selects "Word Processing" instead, a different dropdown menu containing "Get Notepad Editor" and "Get Windows Write" appears instead. If the user were to select the "Get Notepad Editor" entry, Command Post would go to work. Since the subdirectory line consists solely of a period, this indicates to Command Post that the current subdirectory is to be used and no change of subdirectories is to occur. The application line has the filename of the Notepad Editor application, NOTEPAD.EXE, with no parameters. Command Post will issue the commands to load and execute the NOTEPAD.EXE file. In a few seconds, the Notepad Editor appears on the screen. Command Post 6.2 27 An Ample Sample Menu Now that we have seen the basic structure of a Command Post menu, let's explore them some more. In this example we will just use a single main menu heading, but fully flesh out the subdirectory and parameter possibilities. Edit Various Things Edit Command Post Menu c:\windows notepad.exe cmdpost.mnu Edit Highlighted File . notepad.exe @^.^ Write a letter to Home c:\letters write.exe ?Filename for letter?Mom.wri The first of the dropdown menu options above shows a simple way to add in a command to allow easy editing of the Command Post menu file. First of all, the initial directory is set to C:\WINDOWS, which is the suggested home for the CMDPOST.MNU file, and then the Notepad Editor is invoked to edit the menu file. The second example shows an example of Command Post using a highlighted filename from the directory display. If this item is selected, Command Post will obtain the highlighted file from the directory display and insert it into the notepad.exe parameter string. The third example shows an example of a Command Post Prompter. The user will be prompted with a dialog box which states: Please Enter: Filename for letter And is followed by an input box with the suggested default answer already set to "Mom.wri". Command Post 6.2 28 Command Post Keyboard Interface If a keyboard interface (i.e. the underlined characters Windows uses to assist those without mice) to the menus is desired, it is quite simple to add. Just put an ampersand (&) in front of the letter in the menu name to be used for the keyboard interface. The letters will appear in the menus as underlined characters, and thus may be used with ALT key combinations to access the menu items. In order to keep things simple, try (very hard) not to have duplicate underlined letters in the main Bar Menu. In addition, also try not to have duplicate underlined letters within a dropdown menu. If there are duplicate letters identifying menu items, then Windows will toggle between them, and Enter must be hit in order to select the desired one. P.S. In the Bar Menu, do not use F, V, S, W, or C as the keyboard interface characters, as those letters are used either by the MS-DOS executive or by Command Post itself. Below is a sample menu with the keyboard interface defined: &Desktop Get Windows Cloc&k . clock.exe Get &Calendar . calendar.exe Word &Processing Get &Notepad Editor . notepad.exe Get Windows &Write . write.exe Command Post 6.2 29 Advanced Menus Command Post also has certain advanced features that allow control of the menu display on the screen. It is done by simply putting one of two special characters as the first character of the menu name. The special characters are the underline character '_' and the vertical bar '|'. (The vertical bar sometimes has a white space in the middle, and is known as the broken vertical bar.) The effects are as follows: On Bar Menu Items | Causes the item to appear on a new line. _ Ignored. Becomes part of the item name. On Dropdown Menu Items | Causes following menu items to begin in a new column, separated with a vertical bar. _ Causes a horizontal line to be drawn that separates the following menu items from the previous ones. Example: |&Desktop ... Starts on a new line Get Windows Cloc&k . clock.exe _Get &Calendar ... Makes a horzizontal line. . calendar.exe |Word &Processing ... Starts on a new line. Get &Notepad Editor . notepad.exe |Get Windows &Write... Starts in a new column. . write.exe Command Post 6.2 30 Command Post File Name Insertion The Command Post File Name Inserter becomes activated if the parameter string contains any at-sign ( @ ) symbols. There are several special character combinations that Command Post uses to insert files. Along with the following possibilities listed below, is the result if the file C:\WIN\NOTES.TXT is the currently highlighted file: @ Not changed Result = @ @: Provides current disk name Result = C: @:\ Provides disk and path Result = C:\WIN\ @:\^ Provides disk, path and filename root Result = C:\WIN\NOTES @:\^.^ Provides disk, path and full filename Result = C:\WIN\NOTES.TXT @\ Provides path Result = \WIN\ @\^ Provides path and filename root Result = \WIN\NOTES @\^.^ Provides path and full filename Result = \WIN\NOTES.TXT @^ Provides filename root Result = NOTES @^.^ Provides full filename Result = NOTES.TXT Command Post 6.2 31 Command Post File Name Insertion (Continued) Examples: Assume that the filename README.1ST is currently highlighted in the directory display. The following menu will show results of using various combinations of these caret symbols. EditFiles Edit Highlighted file . notepad.exe @^.^ ... will edit README.1ST Edit file relating to root of highlighted file . notepad.exe @^ ... will edit README Edit TXT file associated with highlighted file . notepad.exe @^.TXT ... will edit README.TXT Command Post 6.2 32 Command Post File Name Insertion (continued) Note: Command Post obtains the filenames by performing an Optical Character Read (OCR) of the directory display. For this reason, it is important that the highlighted file name be COMPLETELY VISIBLE and unobscured by other windows or the edges of the window. It is also important that the colors chosen for your Window Text and your Window Background have a lot of contrast. The Window's default black text on a white screen works very well. Non-contrasting color combinations, such as light green text on a light blue background will not work correctly. If Command Post is unable to decipher the highlighted file name, the user will be prompted for it via the Command Post Prompter. A short beep will sound, alerting the user that the OCR read failed. Command Post 6.2 33 Command Post Prompter Details The Command Post Prompter becomes activated if the first character of the parameter string is a question mark "?". Everything following the question mark, up to the next question mark, if any, is assumed to be part of the question. If a second question mark is found, everything after the second question mark is used for the default answer. If there is nothing after the first question mark, a stock question is used. See below for examples of all the possibilities and the results they provide. Prompt String : ? Question : Please Enter: : Parameters for selected application Default : Prompt String : ?? Question : Please Enter: : Parameters for selected application Default : Prompt String : ?Info for this application Question : Please Enter: : Info for this application Default : Prompt String : ?Data for the other app?1 2 3 4 5 Question : Please Enter: : Data for the other application Default : 1 2 3 4 5 Prompt String : ??Jack and Jill Question : Please Enter: : Parameters for selected application Default : Jack and Jill Command Post 6.2 34 Notes Notes - Program Not in Path The examples so far have assumed that the selected application can be found either in the initially selected subdirectory, or someplace defined in the MS-DOS PATH statement. Although this does tend to make things easier, it is not required. The application may be preceded with the complete path specification to it if desired. For Example: &Run Various Things Run &Obscure Program Not In Path \set\desired\path c:\obscure\subdir\obscure.exe assorted parameters Command Post 6.2 35 Notes - Reloading Menus A modified CMDPOST.MNU may be reloaded by simply selecting the Reload menu item in the CmdPost dropdown menu. All Command Post windows use the same menu. If there are two Command Post windows active, and the user selects the Reload menu item on one of them to reload the menu, the menu on the current Command Post window will change immediately. The menu on the other Command Post window will not change immediately, but will update when the window is activated (e.g. mouse click). This may be disconcerting at first, but really is not too bad because: 1) The menus will stabilize after a while and will not need to be reloaded very often. 2) Simply Clicking (or Alt-Tab'ing) the other Command Post window after reloading the menu will reset the menu bar. Command Post 6.2 36 Notes - Automagic Directory Updates Command Post has an automatic directory display update feature that allows the directory display to be updated anytime the Command Post menu is selected. The standard MS-DOS Executive window directory display does not update until the user selects one of the disk drive icons in the upper left of the window. If a file is added or deleted outside of the MS-DOS window (e.g. Notepad adds a file), this fact is not displayed on the MS-DOS window until the disk drive icon is selected. Command Post will, if the Automatic Update Directory Display option has been selected, update the directory display any time the Command Post window is selected. This causes a "blink" after the selection of the Command Post window. An unfortunate side effect of this option is that a highlighted list files will be reset to the unhighlighted state whenever the directory update occurs. If this is overly disconcerting, the feature may be turned off via the Options... dialog box. Command Post 6.2 37 Notes - MS-DOS View Menu selections Command Post will notice and save any selections made to the MS-DOS View dropdown menu. If, for example, it is preferred that the directory display only display executable files (i.e .EXE, .COM, .BAT, and maybe .PIF) the "Programs" View menu subitem would be selected. However, previously, this operation had to be performed every time that MS-DOS was started. When using Command Post, this is automatic. Command Post will reset the MS-DOS View dropdown menu items to the previous state whenever Command Post is started. Command Post 6.2 38 Notes - Exiting Command Post in Windows From time to time it may become desirable to exit from Command Post and remain in a Windows environment, such as when running memory intensive applications such as Aldus Pagemaker. To exit Command Post and remain in Windows, simply select the Exit Command Post item under the File menu. This will exit Command Post, and restore the MS-DOS Executive window. Command Post 6.2 39 Notes - System Information The Command Post System Information display does require some additional explanation, especially for users of "Large- Frame EMS" equipped computers. Most 386 type computers running Windows/386 are "Large-Frame EMS" computers for this discussion. The Command Post System Information display reports on the amount of available memory as seen by the application requesting it. The memory display in the MS-DOS about box, and the memory display that appears when the CmdPost System Information menuitem is selected are usually fairly close (and close is good enough when dealing with Windows memory management). If the computer is not equipped with "Large-Frame EMS" or Windows/386, then the System Information display that appears when you right-doubleclick the Command Post Clock Display will also agree with the previous numbers. However, if the computer has "Large-Frame EMS" or Windows/386, then the System Information display that results from the right-doubleclick of the Clock Display will differ significantly from the other displays. More conventional memory available will be reported, but the total EMS memory available and the conventional memory NON- EMS portion will be nearly the same. The reason for the difference in the conventional memory display and the EMS portion of the conventional memory display is that these numbers are from the viewpoint of the application that wants to know, and each application in your machine has a different conventional EMS memory bank. Command Post and MS-DOS share one of these memory banks, and the Command Post Clock resides in a separate one. As the Command Post Clock is a very small (but required) application, it reports a lot more memory available as it inspects its memory bank. The upshot of all this is that for users of "Large-Frame EMS" or Windows/386, The only numbers that are valid for basing decisions about memory are the amount of EMS memory available, and the amount of conventional NON-EMS memory. When you run out of either one then you cannot start any more applications, and applications already running may have errors due to lack of sufficient memory to operate in. Command Post 6.2 40 Notes - Secret Parameters Windows has a number of "secret" parameters whose existence is not widely publicized. Some of these parameters are useful in alleviating certain memory constraints that users of large-frame (LIM 4.0) memory systems may encounter. Certain applications, including Aldus Pagemaker and Micrografx Designer, need a large amount of the "Conventional NON-EMS memory" as shown in the System Information display. Oftentimes the windows default amount is insufficient for both Command Post and these other applications. The /N and /L parameters described below will solve this particular problem. It is difficult to predict exactly which parameters you will might need, so they are all presented here for your perusal. WIN /N The /N parameter disables the automatic EMS banking of Window applications. EMS memory is still available for Window applications that specifically request it and all DOS applications. Use of this parameter may increase disk activity. WIN /L+xx The /L+xx parameter, where xx is in kilobytes (KB), increases the amount of scarce Conventional NON-EMS memory by xx KB. This is not quite as drastic as /N. Numbers for xx that you might try if you are having memory problems on a multi- megabyte machine are: 20 -- Compensates for Command Post 60 -- Perhaps the best bet. 200 -- Practically the same as /N WIN :app Where app is your application. The : in front of the application name will cause the indicated app to run in a stand- alone environment. No MS-DOS Exec, no Command Post, no other apps. Do not use : with Command Post. WIN Where is a space. This will bypass the opening Microsoft copyright screen, and get you into Windows about 3 seconds faster. Command Post 6.2 41 Appendices: Appendix A - Special Thanks I would like to mention Charles Petzold (who does not have the faintest idea who I am). He is the author of the book "Programming Windows" (the best book on Windows programming available at any price) from which I gained deeper insights into the workings of Windows and lifted several ideas and code fragments. And while I am at it, I should mention Mike Geary (who is as well acquainted with me as Charles Petzold is). He has written articles for the Microsoft Systems Journal, and has made various pieces of source code available on the Compuserve forums. Several of these were incorporated into Command Post. Michael Davis of ThoughtCraft Computing provided the bulk of the code for the Command Post directory tree. ThoughtCraft Computing is currently developing other useful utilities for the Windows environment. There is also Art Metz, who keyed me in on the undocumented secrets that allow Command Post to maintain its clock window on the surface of the screen and allow the clock window to be moved with the mouse button. I am especially grateful for the assistance given by Noel Bergman, who has carefully watched the Command Post memory management algorithms, and has pointed out required changes to allow Command Post to operate in all memory environments. And last, but by no means least, extra special thanks go to the licensees of Wilson WindowWare software, as they are the people who are footing the bill for the continuing development of new and existing WindowWare applications. Command Post 6.2 42 Appendix B - Command Post Version Information Version Information for Command Post 6.2 Immediately below is a list of differences that this version of Command Post has when compared to major previous releases of Command Post. This is generally only of interest when updating to a new version of Command Post from a previous release. Version 6.2 - New Features 1) Directory Tree 2) File Management - Move and Copy to a second Command Post window. 3) Ability to just change directories by using a "." instead of an application in the menus. 4) Screen placement saved when Options dialog box option checked instead of every time Command Post shuts down. 5) OCR stuff works with ALL? video cards now. 6) Share.exe error fixed. 7) Completely personalizable window title. 8) Assorted bug fixes. Version 5.2 - New Features 1) The highlighted filename in the directory display may be copied into the parameter string of an application on startup. 2) Multiple applications may be started from a single menu item. Just put in pairs of the dir/app menu lines. 3) The System Information display now also reports screen resolution. Command Post 6.2 43 Version Information (continued) 4) Doubleclicking the Clock Display with the right mouse button will make the System Information Box appear. 5) If the clock display is counting in minutes, it will NOT pop to the top of the display. 6) The [Press Any Key] box during the blanked display is now optional. If displayed, it is smaller, remains blue and only moves once a minute. 7) Numerous bug fixes. Major fixes are: Hot-Key disabled from Excel Tutorial and Feature Guide Screen Blanker works with Excel Tutorial and Feature Guide. Bug where some full screen oldapps would hang after a while fixed. Full-Screen oldapps started correctly from CmdPost Windows Menu. Screen Stacker/Arranger problem where it would cover the icon area on VGA displays has been fixed. Bug where Command Post sometimeshangs the system when the reminder messages appear on un-licensed copies has been fixed. Bug where clock would slowly move to the lower right of the screen has been fixed. Work-around implemented to a bug in Windows 2.1 running on large-frame EMS systems where dialog boxes sometimes fail to appear due to a memory shortage. Command Post 6.2 44 Version Information (continued) Version 5.0 - New Features 1) Greatly modified clock display 2) Added a System Information menu item to the CmdPost menu. It provides memory usage information. 3) Animation added to the blanked screen display. 4) Added Visa and MasterCard displays to opening screens (as required by my bank) 5) Modified payment structure (but not prices) 6) Reduced Command Post memory usage by about 1000 bytes. Version 4.9 - New Features 1) Removed option that forces user menu to start on a new line, as the | character at the beginning of CMDPOST.MNU does the same thing. 2) Dropdown menu modified to allow single mouse click operation. 3) Clock display can be moved. 4) Doubleclicking the clock display causes Command Post to appear (much like the HotKey) 5) MinimizeMSDos flag checked to see if CmdPost should be minimized after starting apps. 6) Added Window Title personalization via the Option... dialog and removed the "w/Confirm" from the title. Licensed copies only!!! 7) Modified the Command Post clock and memory display to show all 3 types memory on systems with LIM 4.0 Command Post 6.2 45 Appendix C - Other Window Applications Currently (4/1/89) Wilson WindowWare has the following shareware applications. For more information on these applications call, or send a SASE to: Wilson WindowWare 3377 59th SW Seattle WA 98116 (206) 937-9335 Applets 1.1 Applets are a collection of tiny applications for the Microsoft Windows environment. They are primarily designed to operate with Windows menuing environments, such as Command Post 5.2 and newer, which allow you to initiate a series of applications from a single menu selection. These tiny applications include file manipulation tools (COPY, MOVE, RENAME, DELETE), Window manipulation tools (ZOOM, ICONIZE, HIDE, SHOW, CLOSE, PLACE), and miscellaneous tools (SAY, BEEP, SAYBEEP). Browser 3.2 Browser is a MS Windows application designed to allow users to browse files in a MS Windows environment. In addition to the browse capability, it supports printing, clipboarding, and a hex dump display. Browser also features the new and unusual Hide & Seek information extraction technique. Command Post 6.2 Command Post is a MS Windows application designed to allow users to easily personalize the MS-DOS Executive control window. Command Post allows users to easily add menu and dropdown menu items to the main MS-DOS Executive menu bar, and to execute desired applications when a menu item is selected. Also provided are basic file management capabilities and a directory tree. Command Post 6.2 46 Appendix D - Command Post Online Support Online support for Command Post is provided on Compuserve Information Service (CIS). If assistance with Command Post is required, please leave an Easyplex message for Morrie Wilson using the CIS identifier 73260,2535 A response will generally be posted by the next day. The MSAPP forum on Compuserve is also checked on a regular basis. The MSAPP forum is a good place to ask questions about Windows in general, or to interface with other Windows users. Command Post 6.2 47 Appendix E - Patches for Non-English Windows Command Post is designed to work with the United States and the International English versions of Windows. Various foreign language versions are under development. In order to run this version of Command Post with non- English versions of Microsoft Windows, you must add three lines of text to the bottom of your WIN.INI file, and make copies of certain executable files as explained below. The lines added to the WIN.INI file allow Command Post to locate certain critical WIndows and functions whose identify vary with the different language versions of Windows. The copies of the executable files allow Command Post to access certain standard items using the English Windows filenames. First - Modify the WIN.INI file. Add the following lines: [CmdPost] WinTitle=xxx ... WinInfo Parent Window Title WinSession=yyy ... WinInfo Parent Window Class xxx represents the title of the MS-DOS Executive Window. Just type in the exact title of the MS-DOS Window. yyy represents the window class name of the MS-DOS Executive Window. The proper value of this string is much harder to determine, but fortunately it is usually "Session". Supplied with Command Post is a simple utility, WININFO.EXE which should help in determining the correct parameters for your version of Windows. Simply start WININFO.EXE and move your mouse over the title bar of the MS-DOS Executive window. The parent window title and class parameters are just what is required for the WinTitle and WinSession parameters. The examples on the following page show the required additions for a few languages. Command Post 6.2 48 Patches for Non-English Windows (Continued) Examples: English (default) [CmdPost] WinTitle=MS-DOS Executive WinSession=Session German [CmdPost] WinTitle=MS-DOS-Fenster WinSession=Session French [CmdPost] WinTitle=Executif MS-DOS WinSession=Session Norwegian [CmdPost] WinTitle=MS-DOS-Sentralen WinSession=Session Command Post 6.2 49 Patches for Non-English Windows (Continued) In addition you must make copies of some of your files. Command Post will attempt to startup certain applications using the names they have in the English version of Windows. The table below shows the English names of these files, and a few non-English names. Copy the files as they are called in your version of Windows to the names they are called in the English version of Windows. The files are: Function English German Norwegian Clipboard CLIPBRD.EXE ABLAGE.EXE KLIPBRD.EXE Control Pnl CONTROL.EXE SYSTEMST.EXE KONTROL.EXE Command Post has been designed to be translated into various languages. If you are interested in translating Command Post into a language you are familiar with -- a task that takes about 5 hours of your time -- please write us. We will supply you with a file containing all the text strings in Command Post, our gratitude, and the first copy of Command Post in your language. In some cases we will be unable to do this because of prior contractual agreements, but we should then be able to supply you with the name of a contact from whom you may purchase Command Post directly. Command Post 6.2 50 Appendix F - Command Post Licensing Reminders Command Post, being a shareware product, is distributed to users free, or at low cost, for their evaluation. In order to assist users in remembering that they are using an unlicensed version of a shareware product, Command Post reminds users of this fact on a regular basis. The reminders built into this version of Command Post are only somewhat obtrusive. They consist of: 1) The word "Unlicensed" in the title of the Command Post window. 2) Two windows of initial reminders when Command Post is initially invoked. 3) Two windows of reminders every 12 Command Post menu selections. In licensed versions of Command Post, the title of the Command Post window can be completely personalized with a company or user name, as desired. This is accomplished via the Options... dialog box. For example, the title of your main menu window could be something like one of the following: Command Post 6.2 51