Liren Large Software Subsidy 11

home *** CD-ROM | disk | FTP | other *** search

/ Liren Large Software Subsidy 11 / 11.iso / m / m432 / 2.ddi / README.1 < prev next >

Wrap

Text File | 1990-02-06 | 54.6 KB | 1,355 lines

█ Contents Introduction to Shell Clipboard Colors Help Macros Memory Management Program Information Program Information for Menu Item Types Program Information Options Setup Switch Program Work Log Work Log File Work Log Management Work Log Setup Appendix I: Error Messages Appendix O: Shell, Macro Conversion Appendix P: Startup Options█ Introduction to Shell Shell lets you organize programs and commands into a menu structure for easy access. If you run a large number of programs, you can create submenus to group similar programs together. Once you set up a program or command on a Shell menu, you can simply type a menu letter to start the program or execute the command. Shell also acts as a program integrator and memory manager. While running a program from Shell, you can switch to another program without exiting the current one. You can keep as many programs resident at the same time as your computer's memory and hard disk space will allow. Also included in Shell is a clipboard feature. The clipboard is a temporary buffer you can use to transfer information between programs running under Shell. This introduction gives you a brief overview of Shell. For more information on specific features, refer to the alphabetically listed sections that follow the introduction. Starting Shell Each time you turn on your computer, your computer searches for a DOS batch file named AUTOEXEC.BAT. If the AUTOEXEC.BAT file is found, the commands contained in the file are executed. Most likely your system administrator has edited your AUTOEXEC.BAT file to include the commands necessary to log you into the network and start Shell. If this is the case, all you have to do is turn on your computer to start the Shell program (see Starting Shell with an AUTOEXEC.BAT File below). If your AUTOEXEC.BAT file is not set up to start Shell, you can add the necessary commands to the file yourself (see Appendix B: DOS and WordPerfect Office), or you can start Shell from DOS (see Starting Shell from DOS below). Starting Shell with an AUTOEXEC.BAT File You can include the SHELL command in your AUTOEXEC.BAT file to have Shell start each time you turn on your computer (see Appendix B: DOS and WordPerfect Office for details). Starting Shell from DOS To start Shell from DOS, 1 Turn on your computer and log into the network. 2 Change to the network drive and directory containing the Office program files. Consult your system administrator if you are not sure where the WordPerfect Office program files are. 3 Enter notify to start the Notify program, which provides notification when you receive a Mail message or when you are being requested to attend an event. 4 Enter cl/i to install appointment alarms for Calendar. 5 Enter shell to start the Shell program. If you are prompted for your file ID, enter your initials to start Shell. The Shell menu displayed on your screen is the default menu for your network. Your Shell menu may differ from the example above because the system administrator can customize the default Shell menu to meet the general needs of the network users. In the example above, all the programs on the left side of the Shell menu are WordPerfect Office programs. You will find a reference section for each of these programs in this reference manual. The programs on the upper right side of the menu are WordPerfect Corporation programs that you must buy separately. The items on the lower right side let you go to DOS to execute one command and display the WordPerfect Office utilities submenu. Startup Options The options (switches) you can use when starting Editor are briefly described below. For more a detailed explanation of each, see Appendix P: Startup Options. Option Action filename Retrieves the Shell menu indicated. /c-n Allocates amount of memory represented by n to the clipboard. /d-directory Redirects overflow files to the directory indicated. /l Displays the Work Logging screen when Shell starts. /m=macroname Executes the Shell macro indicated as soon Shell starts. /n Does not start any programs set to start resident. /ne Does not let Shell use any expanded memory. /nf Starts non-flash (not-fast) version of Shell. /no Causes Shell to use only available memory (RAM) for switching programs. /ns Starts non-sync version of Shell, which makes some color monitors run faster. /nt-n Lets you select a different network type. /o-[limit];path[limit];path[limit] Causes Shell to use available expanded memory, RAM drive, and hard disk space when switching programs and lets you limit use of each of these resources. /ss-rows,columns Adjusts the screen size to the indicated number of rows and columns. /v-path[limit];path[limit] Causes Shell to use RAM drive and hard disk space only (no expanded memory) for switching programs and lets you limit use of each resource specified. /w-xxx Lets you allocate more memory for executing Shell macros. Starting a Program from Shell To start any of the programs (or commands) listed on the Shell menu, type the corresponding menu letter. You can type an uppercase or lowercase letter. You can also use the arrow keys to move the cursor to a menu item, then press Enter to start the program. Go to Shell Once you have started a program from the Shell menu, you can return to the Shell menu without exiting the current program. In any WPCorp program, press Shell (Ctrl-F1), then select Go to Shell (1). In non-WPCorp programs, press the keys you normally would press to go to DOS without exiting the program. You can also press Switch to Shell (Ctrl-Alt-Space Bar) to go to Shell with a single keystroke. The Shell menu appears with an asterisk (*) next to the menu item for the program you just left to indicate that the program is resident in memory. You can now start another program from the Shell menu or select any of the Shell options (see Shell Options below). When you are ready to return to the program you left resident, return to the Shell menu and select that program. Switch Program You can use Switch Program from within a program to go directly to another program or option on the Shell menu without returning to the Shell. Press Switch Program (Ctrl- Alt-x where x is the menu letter or option number of the program or option you want to switch to). Shell Options Most Shell features can be accessed by typing the number of an option at the bottom of the screen. The Shell options are described below. Go to DOS Select Go to DOS (1) to return to DOS without exiting Shell. Any currently resident programs remain resident. A copy of DOS is started and a «(shell)» message is displayed with the DOS prompt to indicate that DOS is running from under Shell. Press Exit (F7) or enter exit to return to the Shell menu. If you are in a submenu (see Menu Item Type Information under Program Information in Shell Reference), the first option on the Shell feature menu is Go to Shell instead of Go to DOS. Select Go to Shell to return to the next highest Shell menu (the Shell menu that lists the submenu). Any resident programs in the submenu remain resident. Clipboard Select Clipboard (2) to view the contents of the Shell clipboard. With the clipboard displayed, you can clear (delete) the contents, save the contents as a text file, or retrieve a text file into the clipboard (see Clipboard in Shell Reference for details). Other Directory The name of the directory you are in when you start Shell is displayed in the lower left corner of the Shell menu screen. This is the default directory for the Shell program. It is also the default directory for all programs on the Shell menu unless a separate default directory is specified (see Program Information Options in Shell Reference). To change the Shell default directory, select Other Directory (3), then enter the full pathname of a different directory (e.g., c:\work). Setup Use Setup (4) to set up programs on the Shell menu and change the default settings for several Shell features (see Setup in Shell Reference for details). Memory Map Select Memory Map (5) to view a list of the programs currently residing in memory and the amount of memory available (see Memory Management in Shell Reference for details). Log This option lets you manage the Work Logging feature. However, you must set up the feature before you select this option. See Work Log in Shell Reference for details. Function Key Features Select the following features by pressing the function key indicated: Cancel (F1) Use Cancel to back out of (cancel) any Shell menu or prompt. You may need to press Cancel more than once. Exit (F7) You can use Exit to exit Shell (see Exiting Shell below), and throughout the Shell program to exit screens and options and save any changes you have made. Help (F3) Press Help, then follow the on-screen instructions to display information about using Shell features. Exiting Shell To exit Shell and return to DOS, 1 Press Exit (F7) from the main Shell menu. If you have already exited all the programs you started from Shell, you are immediately returned to DOS. If any programs you started from the Shell menu or submenus are still resident in memory, Shell asks if you want to save the information in all resident programs. 2 Type y to save all files currently active in resident programs and exit those programs. or Type n to exit without saving currently active files, then type y to exit Shell. If you chose to save all currently active files in step 2 above, Shell goes to each resident program, starting with the most recently started program. If the file has been modified, the program prompts you for a filename to save the file. After you save the file(s) in a resident program, the program is exited and Shell moves to the next resident program (if any). If the file has not been modified or if it is a program in which you cannot modify a file (such as Calculator or File Manager), the program is exited for you. If you decide you do not want to save an active file, press Cancel (F1) when prompted for a filename, then exit the program as you normally would. As soon as you exit that program, the Shell continues the exiting process. After all programs have been exited, you are asked if you want to exit Shell. 3 Type y to exit Shell and return to DOS.█ Clipboard The clipboard is a special buffer in Shell that you can use to temporarily store selected information. You can then retrieve the clipboard contents at another location in the current program or switch programs to retrieve the information into a different program. Using the Shell feature in Shell-compatible programs or the Screen Copy and Screen Retrieve features with programs that are not Shell-compatible, you can save or append information to and retrieve information from the clipboard. Using the Shell Feature Shell-compatible programs include a Shell feature with options for using the Shell clipboard. How you use these clipboard options and what type of information you can save to and retrieve from the clipboard varies from program to program. The tables below list the type of information you can save to the clipboard (first table) and retrieve from the clipboard (second table) with the Shell feature in WordPerfect Office programs. For details on how to use the Shell feature in WordPerfect, DrawPerfect, PlanPerfect, or DataPerfect, see Shell in the reference manual for that program. Program Save (or Append) to Clipboard Calculator Contents of display register or tape (using Tape feature) Calendar Contents of Memo window, individual appointments, or individual to-do items Editor Macro Mode Blocked text DOS Text Mode Blocked text File Manager File List Text files Look screen Blocked text Mail Send screen Contents of «Send to:» line, Message window, or Files window Create/Edit Group screen Contents of Group Contents window Notebook List display Contents of record(s) Record display Contents of a field Scheduler Schedule screen Contents of any information field Search screen Contents of any information field Create/Edit Group Screen Contents of Group Contents window Program Retrieve from Clipboard Calculator List of numbers (with end-of- line macro) Calendar Any text into Memo window, current Appointment, or current to-do item Editor Macro Mode Text saved from macro mode only DOS Text Mode Any text File Manager Not applicable Mail Send screen Any text into «Send to:» line, Message window, or Files window Create/Edit Group screen Any text into Group Contents window Notebook List display Record(s) Record display A field or any text into current field Scheduler Schedule screen Any text into any information field Search screen Any text into any information field Create/Edit Group screen Any text into Group Contents window Saving/Appending with Screen Copy The Screen Copy feature lets you save a block of text to the clipboard from any program running under Shell. This feature is designed primarily for use with programs that are not Shell-compatible (do not have a Shell feature). It is also useful in Shell-compatible programs for saving information that you cannot save to the clipboard with the Shell feature. For example, you could save a complete Calendar screen with Screen Copy, then retrieve that screen into WordPerfect. To save or append text to the clipboard using Screen Copy, 1 Press Screen Copy (Alt-Shift-■) (hold down Alt and Shift and type a dash) from any program running under Shell, including DOS. 2 Select Rectangle (1) to copy in the Rectangle mode. or Select Block (2) to copy in the Block mode. The Rectangle mode lets you save a rectangular-shaped block of text to the clipboard. All highlighted text in the block, including borders and display attributes, is saved. Use Block mode to block irregularly-shaped areas of text (e.g., a sentence within a paragraph). If you use Block mode, you cannot block border characters (i.e., ASCII characters 176 through 223). If you have a Hercules graphics card in your computer and you have selected 6 or 12 fonts for display, not all display attributes will be copied correctly with Screen Copy. Also, the text in the rectangle or block may not appear in reverse video. When you select Rectangle or Block, the cursor doubles in height. 3 Move the cursor to the beginning of the text you want to copy, then press Enter to anchor the beginning of the rectangle or block. The cursor doubles in height again. 4 Move to the opposite end of the rectangle or block. As you move the cursor, the text in the rectangle or block is displayed in reverse video. If you are in the Block mode, remember that you cannot block border characters and cannot, therefore, move the cursor over a border character. Important: You can only use Screen Copy to save text to the clipboard. If you block text that contains graphics (e.g., a graphics figure in a WordPerfect document), only the text is saved to the clipboard. 5 Press Enter to finish defining the rectangle or block. At this point, you need to select an end-of-line character. An end-of-line character is added to the end of each line of text in the rectangle or block when it is saved or appended to the clipboard. 6 Select Format (3). 7 Select Hard Return (1) to insert a hard return (CR/LF) character at the end of each line. or Select Soft Return (2) to insert a soft return character at the end of each line. or Select Merge Return (3) to save the text in WordPerfect merge file format. A Merge R (^R) code is inserted at the end of each line and a Merge E (^E) code is inserted at the end of the text. The option you select becomes the new default setting for the Format option. If you use Screen Copy again without selecting an end-of-line character, the last character you selected will be used. (Hard Return is the default setting when you start Shell.) 8 Select Save (1) to save the selected text to the clipboard. or Select Append (2) to append the selected text to the end of the clipboard contents. Retrieving with Screen Retrieve You can use the Screen Retrieve feature to retrieve the contents of the clipboard into any program running under Shell. When you use Screen Retrieve, however, all formatting characters are removed and text is retrieved one character at a time in a continuous string. You can format text retrieved with Screen Retrieve using an End of Line macro (see End of Line Macro Name under Program Information Options in Shell Reference). Because the Retrieve Clipboard feature retains formatting characters, it is usually best to use Retrieve Clipboard instead of Screen Retrieve to retrieve text into Shell- compatible programs. To use Screen Retrieve with any program running under Shell (including DOS), 1 Position the cursor where you want the contents of the clipboard inserted. 2 Press Screen Retrieve (Alt-Shift-+). Saving with a Clipboard Filename For programs that are not Shell-compatible (do not have a Shell feature), you can also save information to the clipboard by first saving it to a special clipboard file (see Clipboard Filename under Program Information Options in Shell Reference). When you switch programs or exit the program, the information in the file is saved to the clipboard. You can then retrieve the contents of the clipboard into another program as you normally would. This method of saving to the clipboard is simply an alternative to the Screen Copy feature. Viewing the Clipboard Contents You can view and manage the contents of the clipboard with the View Clipboard feature. 1 From the Shell menu, select Clipboard (2) to display the contents of the clipboard. This is not an editing screen, but you can scroll forward through the displayed text with Down Arrow () or Page Down (PgDn or + on the number pad). If you only want to view the text in the clipboard, press Exit (F7) when you are finished to return to the Shell menu. Otherwise, 2 Select Clear (1) to clear (delete) the contents of the clipboard. or Select Save as Text File (2), then enter a filename to save the contents of the clipboard as a DOS text file. (This does not clear the clipboard contents.) or Select Retrieve Text File (3), then enter the full pathname of a DOS text file to retrieve a file into the clipboard. You should retrieve DOS text files into the clipboard only from this screen. Any file you retrieve is appended to the end of the clipboard contents. 3 Press Exit (F7) to return to the Shell menu. Clipboard Memory Management Shell allots 1K of memory for the clipboard. When you use the clipboard to save information that requires more memory, Shell creates a temporary file on disk to store the additional information. Both the clipboard and temporary file are deleted when you exit Shell. You can use the /c-n startup option to change the amount of clipboard memory allotted to 2K, 3K, 4K, or 5K (see Appendix P: Startup Options). This does not affect the amount of information that can be stored in the clipboard; it only affects how soon the clipboard overflows to disk. If you use the clipboard frequently to transfer large blocks of text, increasing the amount of clipboard memory may increase the speed at which text is saved to and retrieved from the clipboard. If Shell is running from a network directory, you may not have the network file rights necessary to create overflow files in that directory. You can use the /d-directory Shell startup option to redirect overflow files to a directory to which you do have rights (see Appendix P: Startup Options). If you are not sure what rights you have with various directories, consult your system administrator.█ Colors If you have a color monitor, the Colors option on the Setup Options menu lets you change the screen colors for Shell. If you do not have a color monitor, changing Colors settings has no effect on screen display. To change the Shell colors, 1 Select Setup (4) from the Shell menu. 2 Select Options (2). 3 Select Colors (1) to display the Color Setup screen. 4 Select the type of monitor you have (color, single color, or Hercules RamFont card), then enter the necessary information (see Color Setup Options below). 5 Press Exit (F7) twice to save the changes and return to the Shell menu. Initially, all WordPerfect Office programs use the Shell Colors settings. You can set screen colors independently in all Office programs except File Manager, which always uses the Shell colors. The Colors options for each Office program are the same as in Shell (see Color Setup Options below). If you change screen colors in Calendar, Editor, Mail, Notebook, or Scheduler, the new settings remain in effect until you change them again. Changes you make to colors in Calculator remain in effect until you exit Calculator, then the Shell colors settings are restored. Color Setup Options The Color Setup options correspond to three different types of color monitors. Color Monitor Use this option to adjust the colors on computers with a CGA or compatible color system. 1 Select Color Monitor (1) from the Color Setup screen. You are asked if you want to use fast text display. 2 Type y to increase the speed at which Shell displays text. (This may cause snow on some monitors.) or Type n if you do not want to use fast text display. A table appears from which you can select colors for background, foreground, and several text attributes. 3 Make the desired changes. Changes you make are reflected in the sample text. 4 Press Exit (F7) to save the changes and return to the Setup menu. Single Color Monitor To change the underline display on a black and white or Compaq monitor, 1 Select Single Color Monitor (2) from the Color Setup screen. You are asked if you want to use fast text display. 2 Type y to increase the speed at which Shell displays text. (This may cause snow on some monitors.) or Type n if you do not want to use fast text display. 3 Select Underline Displayed as Reverse Video (1). or Select Underline Displayed as Underline (2). 4 Press Exit (F7) to save the changes and return to the Setup menu. Hercules RamFont Card If you have a Hercules InColor Card or Hercules Graphics Plus Card, 1 Select Hercules RamFont Card (3) from the Color Setup Screen. Three new options appear. 2 Select Monochrome Mode (1) to emulate a monochrome monitor, with true bolding and underlining. or Select CGA Mode (2) to emulate a standard CGA color monitor. The same color table appears as when you select Color Monitor as the monitor type (see Color Monitor above). or Select No Mode Changes (3) to use the color and/or extended font capabilities of the Hercules RamFont card (see No Mode Changes below). The same color table appears as when you select Color Monitor (see Color Monitor above), except that the colors you selected for the Hercules color palette appear instead of the CGA colors. (See your Hercules manual for details on setting up the color palette.) If you select Monochrome Mode, you are returned to the Setup menu. If you select CGA Mode or No Mode Changes, 3 Make the desired changes in the color table. Changes you make are reflected in the sample text. 4 Press Exit (F7) to save the changes and return to the Setup menu. No Mode Changes If you select No Mode Changes to use the Hercules color palette, your color settings may not hold when you switch to a different program and return or when you exit and then restart the current program. This may cause text to be almost invisible because foreground and background colors are almost the same. You can avoid this problem by using the same color settings in all programs or you can create a DOS batch file that restores the Hercules color settings when a problem occurs. Use Editor (DOS text mode) to create a DOS batch file (a file with .BAT extension) that contains the commands necessary to reset the Hercules card state, font, and colors. The following commands represent a sample batch file named RESET.BAT: Command Meaning palette mycolors.pal Reset Hercules card state and colors. ramfont courier.fnt Reset font. To execute the batch file, select Go to DOS For One Command (usually g) from the Shell menu, then enter the full pathname of the file. After the batch file is executed, press any key to return to the Shell menu. If you have room on your Shell menu, you can add the batch file as a Shell menu item. Then you can simply select that item to reset your Hercules colors. (See Program Information in Shell Reference for details on setting up a DOS batch file as a menu item.) Using 512 Characters In WordPerfect version 5.0 or later or PlanPerfect version 5.0 or later, it is possible to use 512 character fonts with the EGA, VGA, or Hercules InColor Card. While using WordPerfect or PlanPerfect with 512 character fonts, Calendar alarms or Shell prompts may be unreadable. This happens because the display attributes used (Bold, Underline, etc.) are interpreted differently in this mode. You can avoid this problem with the EGA or VGA card by using only colors A through F for your display attributes in any Office program. When using the Hercules InColor Card, use only colors A, C, E, G, H, I, K, M, and O in Shell and Calendar.█ Help You can use the Help feature to display information about Shell features. 1 Press Help (F3). The main Shell Help screen is displayed with instructions for using the Help feature. 2 Press any function key, cursor movement key, or editing key to view information about the feature assigned to that key. or Type one of the letters in the topical guide to learn about a specific topic. If the information for the feature or topic occupies more than one screen, the «More . . . Type 1 to continue:» message appears at the bottom of the screen. Type 1 to view successive screens on the same feature or topic. You can return to the main Help screen at any time by pressing Escape (Esc). When you finish using Help, 3 Press the Space Bar or Enter to exit the Help feature. Context-Sensitive Help You can also access Help from any menu or prompt to display information about the feature you are using. For example, if you select Clipboard (2) and then press Help (F3), information about the clipboard is displayed.█ Macros Using the Macro feature, you can record the keystrokes you press for a certain task, then later execute the macro to have Shell perform those keystrokes for you. For example, you can define a macro to perform the following tasks: Back up the files in a directory to a disk. Save text to the Shell clipboard. Change the initial (default) settings for a program. Almost any task you can do manually from Shell or a program running under Shell, you can automate with a Shell macro. You can also use macro programming commands to program a Shell macro for specific tasks. Defining a Shell Macro You can define a Shell macro while in Shell or in any program running under Shell, except DOS. To define a simple Shell macro that executes keystrokes, 1 Press Define Shell Macro (Ctrl-Shift-F10). 2 Enter one to eight characters to name the macro. or Hold down Alt and Shift and type a letter from A to Z. 3 Enter a description for the macro (up to 39 characters). or Press Enter to bypass entering a description. The «* Starting shell macro *» message is briefly displayed at the bottom of the screen. Also, «Macro Def» appears at the bottom of the Shell menu screen until you finish defining the macro. 4 Press the keystrokes you want recorded in the macro. 5 Press Define Shell Macro again to end macro definition. The «* Shell Macro Ended *» message appears briefly at the bottom of the screen. Shell Macro Filename Shell uses the name you give plus a .SHM extension to create the filename for the macro. For example, if you enter print as the macro name, the filename for the macro will be PRINT.SHM; if you hold down Alt and Shift and type p for the macro name, the filename will be ALTSHFTP.SHM. Shell macros are saved to the default directory specified on the Program Information screen of the program where you begin defining the macro. You can, if desired, include a full pathname when naming a macro with one to eight characters to save the macro to a different directory. If a macro with the same filename already exists in the destination directory, Shell asks if you want to replace the original macro. Type y to replace the original and continue defining the new macro, or type n and enter a new macro name to preserve the original. Macro Description Use the description as a reminder of what the macro does should you later need to edit the macro. The description is displayed in the Macro Summary screen after you retrieve the macro into Editor (see Options in Editor Reference). Executing a Shell Macro The way you execute a Shell macro depends on how you named the macro. If you named the macro with one to eight characters, 1 Press Shell Macro (Alt-Shift-F10) from the Shell menu or from any program running under Shell. Important: When you execute a Shell macro, make sure you are in the same location (same program and state) as you were when you defined the macro. This ensures that the macro does what you want it to do. 2 Enter the name of the Shell macro. You do not need to include the .SHM extension. If you do not include a pathname for the macro (e.g., c:\macros\print), Shell looks for the macro in the default directory specified on the Program Information screen for the current program. To start a macro named with the Alt-Shift keystroke, simply press Alt-Shift-letter (where letter is the letter you used to name the macro; e.g., Alt-Shift-d). Macro Not Found If no macro is found when you press Alt-Shift-letter, the keystroke performs the same function as the Switch Program feature (Ctrl-Alt-menu letter). See Switch Program in Shell Reference for details. For example, if you press Alt-Shift-w and no file named ALTSHFTW.SHM is found, you will be switched to whatever program is assigned to «W» on the Shell menu. If there is not a menu item assigned to that letter, you are returned to the Shell menu. Canceling a Shell Macro You can cancel a Shell macro in progress by pressing one of three keys. If you have not pressed any keys since starting the macro, press Cancel (F1) to stop the macro. If you have pressed other keys, press Cancel Macro (Alt-Shift-F1) or Shell Macro (Alt-Shift-F10) to stop the macro. Advanced Shell Macros You can create complex macros with the macro programming commands (a programming language). See Appendix G: Editor and Shell, Programming Commands for details.█ Memory Management One of the most useful applications of Shell is the ability to keep multiple programs resident in memory and switch from program to program with a single keystroke (see Switch Program in Shell Reference). If you plan to use this feature, it is helpful to understand how Shell uses your computer's memory to keep programs resident. When you start Shell, there are already at least two programs resident in memory: DOS and Shell. If you loaded any other programs before starting Shell (such as network device drivers and the Office notification program NOTIFY.EXE), those programs are also resident. As you continue to start programs from Shell and leave them resident in memory, more and more of your computer's memory is used. It logically follows that the more memory your computer has, the more programs you can have resident at one time. How Shell Uses Memory When you start a program, the information necessary to run that program resides in conventional memory (the first 640K of RAM). When you leave a program resident to switch to another program (see Switch Program in Shell Reference), the current program is either left in conventional memory or swapped to one of several locations, depending on the current operation mode and conditions. The sections below describe several Shell startup options that help you control how Shell uses memory. For details on how to use any of these startup options, see Appendix P: Startup Options. Default Mode In its default operation mode, Shell uses any available expanded memory, hard disk space, and/or RAM drive space to keep programs resident. However, there must be more space available in these combined locations than in conventional memory (almost always the case) or the program is left in conventional memory. Shell supports the Lotus/Intel/Microsoft (LIM) expanded memory specification. When swapping to one of these locations, expanded memory (if any) is used before hard disk or RAM drive space. If you use the default mode, you can use the /o startup option to specify the drive or drives (a maximum of two) you want Shell to use after it uses all available expanded memory. For example, you could specify a RAM drive and a hard disk or a local hard disk and a network hard disk. You can also limit use of expanded memory and/or each disk drive to a specific number of kilobytes. If you do not want Shell to use expanded memory, use the /ne or /v startup options (see Virtual Mode below and Appendix P: Startup Options). Virtual Mode Use the /v (virtual) startup option to run Shell in the virtual mode. In the virtual mode, Shell uses only hard disk and/or RAM drive space to swap programs. However, there must be more space available on the hard disk and/or RAM drive than in conventional memory or the program is left in conventional memory. As with the /o startup option (see Default Mode above), you can use the /v startup option to specify the drive or drives (a maximum of two) you want Shell to use. Conventional Mode If you do not want Shell to use expanded memory or hard disk and/or RAM drive space for program swapping, use the /no startup option. Insufficient Memory If there is not enough memory to swap a program while operating in any of the modes above, the following message is displayed: ERROR: Insufficient memory You will need to exit one or more resident programs before you can start the next one (see Using the Memory Map below). Using the Memory Map Select Memory Map (5) from the Shell menu to display a screen similar to the one below. Any currently active programs are listed by name in the top window in the order they were started. Programs or device drivers loaded into memory before you started Shell may appear as «(Unknown Name)» on the list. The amount of memory (number of bytes) used by each program is displayed to the right of each program name. An «E» appears next to any program currently swapped to expanded memory, and a «D» appears next to any program currently swapped to disk. If there are more programs resident than can be displayed in the window, press Down Arrow () or Page Down (PgDn) to view the remaining programs. The amount of available memory is displayed in a separate window below the program list. The amount of conventional DOS memory available is always listed. If you have expanded memory or have used the /o or /v startup option to swap programs to disk, the amount of expanded memory and/or disk space available is also displayed. Using the available memory information and the approximate memory specifications for the programs you use, you can determine which combinations of programs you can have resident at the same time. See Program Memory Requirements below for the memory requirements of WordPerfect Corporation programs. For the memory requirements of other programs, see their respective reference manuals. After viewing the Memory Map, press any key to return to the Shell menu. Program Memory Requirements The table below lists the memory requirements for WordPerfect Corporation programs. The figures given are only approximations. The actual memory requirements may be slightly higher or lower, depending on the conditions the programs are operating under. Program Memory Required WordPerfect Office Calculator 34K Calendar 180K Editor 160K File Manager 80K Mail 270K Notebook 200K Scheduler 300K Shell 48K Other WPCorp Programs DataPerfect 2.0 112K DataPerfect 2.1 112K DrawPerfect 1.0 384K PlanPerfect 3.0 260K PlanPerfect 5.0 384K WordPerfect 4.2 196K WordPerfect 5.0 384K WordPerfect 5.1 384K █ Program Information When you add a program or command to the Shell menu, you must enter the information Shell needs to display the item on the menu and to execute the program or command when you select that item. You enter this information in the Program Information screen. Entering Program Information To enter the program information for a new menu item, 1 Select Setup (4) from the menu at the bottom of the Shell screen. 2 Use the arrow keys or type a menu letter to move to an empty letter in the Setup menu. 3 Select Edit (1) or press Enter to display the Program Information screen for that letter. You cannot display the Program Information screen for a program that is resident in memory. 4 Use Down Arrow () or Tab to move forward through the Program Information options, and use Up Arrow () or Shift-Tab to move backward through the options. As you move from option to option, a Help message about the current option is displayed at the bottom of the screen. 5 Enter the information necessary for the program or command you are adding. The options you will need to use depend on the type of menu you are adding. For details on which settings to use with a particular menu item, see Program Information for Menu Item Types in Shell Reference. See Program Information Options in Shell Reference for descriptions of the Program Information options and instructions on how to use them. 6 Press Exit (F7) twice to save the changes and return to the Shell menu. Editing Program Information You can follow the steps above to edit program information after you have entered it. While in the Program Information screen, you can use any of the following cursor movement and editing keys to edit text: Name Key Character Left/Right Left/Right Arrow (/) Beginning/End of Line Home,Left/Right Arrow (Home,/) End of Line End Delete Character Left Backspace Delete Character Right Delete (Del) Delete to End of Line Ctrl-End If you begin typing before you use a cursor movement or editing key, the existing text is replaced by the text you type. When editing a line of text, you can press Cancel (F1) to restore the original text, but you must do so before pressing Enter or moving to a different line. You can also cancel all changes made to Shell setup by pressing Cancel (F1) from the Setup menu and typing y. Switching Program Information Screens While editing a Program Information screen, you can press Page Up (PgUp) or Page Down (PgDn) to display the Program Information screen for the previous or next item on the Shell menu. This also saves any changes you have made to the current Program Information screen.█ Program Information for Menu Item Types The type of Shell menu item you create determines what the settings for certain Program Information options should be, and which options you can and cannot use. The sections below contain tables of the Program Information options and what the settings for those options should be for specific menu item types. For details on how to change the settings, see Program Information in Shell Reference. If the setting for an option that requires you to enter text is «Not applicable,» do not enter anything for that option. If the setting for any option is «Optional,» refer to the explanation of that option in Program Information Options in Shell Reference to decide whether you need to use that option. Program To add a Shell-compatible program (i.e., WordPerfect Corporation programs) as a Shell menu item, include the following information on the Program Information screen: Option Setting Menu Letter Any available letter Menu Description A description of the program Menu Item Type Normal Program Name The name of the executable (program) file Default Directory Optional Clipboard Filename Optional Macro Names Optional Startup Options Optional Prompt for startup options?No or Yes Start resident? No or Yes DOS Command or Batch File To add a DOS command or batch file of DOS commands as a Shell menu item, include the following information on the Program Information screen: Option Setting Menu Letter Any available letter Menu Description A description of the command or batch file Menu Item Type DOS/Batch Program Name Optional Default Directory Optional Clipboard Filename Optional Macro Names Optional Startup Options DOS command parameters Prompt for startup options?No or Yes Start resident? No If the item is a DOS command (e.g., format.com), you can enter the command in one of two ways. Enter the command on the Program Name Line and the parameters for that command (if any) on the Startup Options line, or enter the command and the parameters on the Startup Options line. Including command parameters after the filename on the Program Name line will produce an error. Set «Prompt for startup options?» to Yes or enter a prompt on the Startup Options line (see Startup Options in Shell Reference) if you want to enter command parameters when executing the command. The Go to DOS For One Command option on the Shell menu is simply a DOS/Batch item with nothing on the Program Name Line and a ?"DOS Command: " prompt on the Startup Options line. For a DOS command or batch file menu item to work properly, you must have the COMMAND.COM file in your root directory, or the COMSPEC string in the environment must indicate where the COMMAND.COM file is (see SET in your DOS manual). When you execute the DOS command or batch file from the Shell menu, Shell loads another copy of DOS to execute the command or batch file. When the command or batch file has been executed, press any key to return to the Shell menu and exit the second copy of DOS. If you do not want the «Press any key to continue ...» message displayed after the command is executed, define the command as a Normal menu item type (see Programs above). Enter COMMAND.COM for the program name, then enter /c command parameters on the Startup Options line. With this method, you load COMMAND.COM and use the /c switch to return control to Shell immediately after the command on the Startup Options line is executed. For example, the Program Information screen below is set up to execute the FORMAT.COM command when the user selects «Format (drive)» from the Shell menu. Notice the message on the Startup Options line. When the user enters a drive letter at the prompt, a colon is added after the drive letter, and the result is passed to the format command as the command's parameters. Submenu If you run out of room on the Shell menu, you can create submenus for additional items. You can also use submenus to create separate menus for similar items. To add a submenu as a Shell menu item, include the following information on the Program Information screen: Option Setting Menu Letter Any available letter Menu Description A description of the submenu Menu Item Type Submenu Program Name Not applicable Default Directory Optional Clipboard Filename Not applicable Macro Names Not applicable Startup Options Submenu filename,/l,/m-macro name, and/or /n Prompt for startup options?No or Yes Start resident? No or Yes You must include a submenu filename as a startup option for the Submenu item type to work. When you select this item from the Shell menu for the first time after setting it up, the message «ERROR: File not found» is displayed because you have not yet created the file for the new submenu. A blank Shell menu is then displayed. Set up the submenu using the Setup feature (see Setup and Program Information in Shell Reference). When you exit the submenu, any changes you made to the menu are saved in the file indicated by the filename on the Startup Options line. Shell Macro To add a Shell macro as a Shell menu item, include the following information on the Program Information screen: Option Setting Menu Letter Any available letter Menu Description A description of the Shell macro Menu Item Type Macro Program Name Full pathname of the Shell macro Default Directory Not applicable Clipboard Filename Not applicable Macro Names Not applicable Startup Options Optional Prompt for startup options?No or Yes Start resident? No or Yes If there is any text you want to be able to use within the macro, you can enter that text on the Startup Options line. You can also set «Prompt for startup options?» to Yes and then enter the text when you start the macro. The text you enter is assigned to macro variable 0 and can be used in the macro if you insert an {ALT-SHIFT-0} command (see Appendix H: Editor and Shell Macros, Variables). If you set «Start resident?» to Yes, the macro is executed when you start Shell. Pause You can use the Pause menu item types for certain programs that perform a function and then exit (or quit) when that function is completed. If you add such a program to the Shell menu as a Normal program and then start it from the Shell menu, the program will execute and return to Shell immediately. If the program displays a screen with the results of its function before exiting, you need to define the program as a Pause type to have Shell display that screen until you press any key to continue. The settings for the Pause type are the same as for the Program type (see Program above). Heading You can create bolded headings in a Shell menu to set apart similar programs or display other types of information. To create a bolded heading as a Shell menu item, enter the following information on the Program Information screen: Option Setting Menu Letter Any available letter Menu Description The text of the heading Menu Item Type Normal Program Name Must be empty Default Directory Not applicable Clipboard Filename Not applicable Macro Names Not applicable Startup Options Not applicable Prompt for startup options?No Start resident? No The menu description is displayed on the Shell menu as a bolded heading, without the menu letter. The item's menu letter will still appear on the Setup menu and the Program Information screen. Important: For this menu item type to work properly, you must leave the Program Name line blank. TSR Program You can add a TSR (Terminate and Stay Resident) program to the Shell menu using the TSR Manager program included with WordPerfect Office (see Appendix Q: TSR Manager for details). Important: Always use TSR Manager to start TSR programs from the Shell menu or start the TSR programs before you start Shell. This will avoid possible conflicts between Shell and other TSR programs.