Liren Large Software Subsidy 11

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

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

Wrap

Text File | 1990-02-06 | 63.5 KB | 1,573 lines

█ Program Information Options This section provides a description of each of the Program Information options. The options are listed in the order in which they appear in the Program Information screen. See Program Information in Shell Reference for instructions on how to display the Program Information screen for a particular Shell menu item. Also, see Program Information for Menu Item Types in Shell Reference for details on which of the options described below you should use with particular types of menu items. Menu Letter The menu letter is the letter that appears next to a program on the Shell menu. This is the letter you type from the Shell menu to start a program. To change the current menu letter, move to the Menu Letter option, then type a new letter. You can also change the menu letter from the Setup screen (see Setup in Shell Reference). While in the Setup screen, move to the item whose menu letter you want to change, hold down Alt, and then type the new menu letter. Shell does not allow duplicate menu letters for menu items. If you attempt to assign a menu letter that is already assigned to another menu item, Shell warns you of the duplication and asks if you want to clear the duplicate letter. Type y to clear the letter from the formerly assigned menu item and assign it to the current item, or type n to cancel the assignment, then type a different letter. If you clear a duplicate letter, the Menu Letter setting for that item remains blank until you assign a new menu letter. You must assign a new letter before you can use that menu item again. Menu Description Use this option to enter the text (up to 30 characters) you want to appear next to the menu letter on the Shell menu. Menu Item Type Shell must know what type of item a program or command is in order to execute it correctly. Move the cursor to the Menu Item Type setting, then type a letter from the list below to select the correct type. If you type an invalid letter, the setting will not be changed. Letter Setting d DOS/Batch (DOS command or batch file) m Macro (Shell macro) n Normal p Pause s Submenu Normal (for «normal» programs) is the default setting for Menu Item Type. If you are adding a menu item that must be handled differently than a normal program, select the appropriate item type. See Program Information for Menu Item Types in Shell Reference for an explanation of which menu item type you should select for various programs. Program Name The program name is the name of an executable file (a file with a .EXE, .COM, or .BAT extension) that starts a program or executes a command or batch of commands. For example, CL.EXE is the program name for Calendar. On the Program Name line, enter the filename of the program you want to start or command you want to execute when you select this item from the Shell menu (see Appendix M: Program Files for a list of WordPerfect Corporation program filenames). If you do not enter the path, Shell looks for the file first in the in the current Shell default directory, and then in the directories specified with the PATH command in your AUTOEXEC.BAT file (see Appendix B: DOS and WordPerfect Office). It is a good idea to include the full pathname of the file (e.g., f:\wpoffice\calc.exe) so Shell will find the file even if you later change the default directory or edit the PATH command. Default Directory The directory you enter here becomes the default directory for this menu item. If you do not enter a default directory, the item uses the Shell default directory displayed at the bottom of the Shell menu. Clipboard Filename You can use the Clipboard Filename option to save text to the clipboard from programs that are not Shell-compatible (do not have a Shell feature with options for saving to the clipboard). Important: You can also use the Screen Copy feature to save text to the clipboard from programs that are not Shell- compatible (see Clipboard in Shell Reference). Using a clipboard filename is simply an alternative to using Screen Copy. To use this method of saving text to the clipboard from a program, you must enter a filename on the Clipboard Filename line for that program. When you later start the program, you can save selected text to the clipboard file. When you switch programs or exit the program, the text in the clipboard file is saved to the clipboard. You can then retrieve the text from the clipboard with the Retrieve Clipboard or Screen Retrieve feature (see Clipboard in Shell Reference). Macro Names You can define an End of Line Shell macro for a program to add specific characters to the end of each text line when you use Screen Retrieve in that program. You can also define Go to Shell and Return from Shell macros that make the Switch Program feature (Ctrl-Alt-menu letter) work in a program that is not Shell-compatible the same as in a program that is. See Clipboard and Switch Program in Shell Reference for details on the Screen Retrieve and Switch Program features. Changing Macro Names When you define an End of Line, Go to Shell, or Return from Shell macro for a program (see Defining Special Macros below), you must use the name that appears on the Program Information screen for that program. The preset macro names are listed below. Macro Type Macro Name End of Line EOLX.SHM Go to Shell GOSHELLX.SHM Return from Shell RTSHELLX.SHM When you first enter information for a program, the X (the variable character) in each macro name above is blank. If you plan to use one of the macros, you must insert a variable character in the macro name. To add or change the variable character for the macro names, 1 Move the cursor to the Macro Names line. Notice that the variable characters in all three macro names are highlighted. All three macro names use the same variable character. 2 Type the desired letter or number. The character you type appears in all three macro names. Whenever you use Screen Retrieve in a program, Shell looks for the End of Line macro whose name appears on the Program Information screen for that program. Whenever you use Switch Program, Shell looks for the Go to Shell and Return from Shell macros specified on the Program Information screen for that program. Shell looks in the current default directory specified on the Program Information screen for the program you are in when you start the macro. Shell executes the macro(s) if it finds them. Defining Special Macros To define an End of Line, Go to Shell, or Return from Shell macro, 1 Press Define Shell Macro (Ctrl-Shift-F10) from the Shell menu or from any program running under Shell. 2 Enter eolx (where x is a letter or number) as the macro name if you are defining an End of Line macro. or Enter goshellx (where x is a letter or number) for a Go to Shell macro. or Enter rtshellx (where x is a letter or number) for a Return from Shell macro. Shell adds the .SHM extension to the macro filename. 3 Enter a description. or Press Enter to bypass entering a description. 4 Press the necessary keystrokes (see End of Line, Go to Shell, and Return from Shell below). 5 Press Define Shell Macro again to end macro definition. You can define a separate End of Line, Go to Shell, and Return from Shell macro for each program on the Shell menu. You can also use one macro with more than one program by specifying that macro name on the Program Information screens for all the desired programs. End of Line When defining an End of Line macro for the Screen Retrieve feature, press the keystrokes (e.g., Tab, Hard Page, etc.) and/or type the characters you want added to the end of each line. Go to Shell You can define a Go to Shell macro to use Switch Program with a program that is not Shell-compatible. However, the program must be able to go to DOS or execute a single DOS command without exiting the program. It is usually easiest to define a Go to Shell macro from within the program you are defining it for. After entering the macro name and description, press the keystrokes that take you to DOS or let you execute a single DOS command (e.g., the RUN SHELLDOS command for dBASE, the /s command for Lotus 1-2-3). When running a program from Shell, pressing the keystrokes to go to DOS returns you to Shell and leaves the program resident. Defining a Go to Shell macro for a program is usually sufficient to make the Switch Program feature work. However, a Return from Shell macro is necessary for some programs (see Return from Shell below). Return from Shell You need to define a Return from Shell macro for a program if you cannot return directly back to the program by simply selecting that program on the Shell menu. For example, some programs return you to DOS, where you must enter an additional command to return to the program. When defining a Return from Shell macro, press the keystrokes you would normally press to return to the program from Shell (only the keystrokes you must press after selecting the program from the Shell menu). Startup Options On the Startup Options line, enter the desired startup options (up to 30 characters) for an item. For example, if you want the FORMAT macro executed each time you start Calendar, include the /m-format startup command on the Startup Options line for Calendar. (See Appendix P: Startup Options for a complete list of the startup options available for WordPerfect Office programs.) If the program name is a DOS command, use the Startup Options line to enter the command parameters. If you want to be able to insert different options and commands in the command line each time you select a Shell menu item, use a question mark (?), followed by a message in quotes to pause the startup process and prompt the user for input. Insert the prompt where you want the input inserted in the command line. For example, if you want to be able to execute a variety of macros when starting WordPerfect, you could enter /m-?"Macro name: " on the Startup Options line. Then, whenever you start WordPerfect, Shell pauses, displays the «Macro name:» prompt, and waits for you to enter a macro name. The text you enter is used as the macro name parameter of the /m-macroname startup option. As soon as you press Enter, the startup process continues. You can use more than one question mark on the Startup Options line for a program. Shell will pause for input at each question mark. If you run out of room on the Startup Options line, you can set «Prompt for startup options?» to Yes to prompt the user for additional startup options when starting the program (see Prompt for Startup Options below). Prompt for Startup Options If the «Prompt for startup options?» setting is Yes, Shell displays the «Enter options:» prompt each time you start that program. Shell then waits for you to enter startup options (up to 60 characters). The startup process continues as soon as you press Enter. If you enter startup options when starting a program, Shell records the startup options you enter in a special buffer. The next time you start that program, the last startup options you entered appear at the «Enter options:» prompt. As you continue to use the prompt for startup options with this program or other programs, each set of startup commands you enter is recorded separately in the buffer. The buffer can hold up to 256 bytes or normal characters of information. If the buffer is full when you enter startup options at the «Enter options:» prompt, Shell deletes the oldest set of startup options to make room for the new one. If you create your own prompt on the Startup Options line (see Startup Options above), the Startup Options buffer also stores text entered from that prompt. Use the following keys to view and edit the startup options entries displayed after the «Enter Options:» prompt. Keys Actions Up/Down Arrow (/) Moves forward/backward through the startup options entries saved in the buffer. Delete Entry (Ctrl-PgDn) Deletes the current entry from the buffer. Delete All (Ctrl-PgUp) Deletes all entries in the buffer. Clear Entry (Esc) Clears the line without deleting the current entry from the buffer. Execute Entry (Ctrl-Enter) Executes the current entry without saving it to the buffer. If desired, you can set «Prompt for startup options?» to YES and include startup options on the Startup Options line (see Startup Options above). If you do, the options on the Startup Options line will be inserted in the command line before the options you enter at the «Enter options:» prompt. Start Resident If you set «Start resident?» to Yes, a plus sign (+) appears next to that item in the Setup menu indicating that the program will be loaded into memory each time you start Shell. Only programs that are fully Shell-compatible (e.g., WordPerfect Corporation programs) should be set to start resident. You can also change the «Start resident?» setting from the Setup menu by moving to a menu item, then typing a plus sign (+). When you start Shell, each of the programs set to start resident is loaded into memory if there is enough memory available (see Memory Management in Shell Reference). An asterisk (*) appears next to the item on the Shell menu to indicate that the program has already been started.█ Setup There are Setup options for changing the Shell menu and for changing the default settings for several Shell features. Select Setup (4) from the menu at the bottom of the Shell screen to display the Setup menu. «Setup Menu» appears in the Shell menu heading and menu letters for any empty menu items appear. Also, the Setup options appear at the bottom of the screen. If the «Enter Password:» message is displayed when you select Setup, the Setup feature has been protected with a password (see Password below). Four of the Setup options (Edit, Add, Delete, and Move) are used to make changes to the Shell menu (see Shell Menu Setup below). Use Options to change the default settings for several Shell features (see Shell Feature Setup below). Settings you change with the Setup feature remain in effect until you change them again. Shell Menu Setup Use the options described below to edit the Shell menu. If you decide you don't want to change the Shell menu after you begin editing it, press Cancel (F1), then type y at any time before exiting the Setup feature to restore the original Shell menu. Edit Selecting the Edit option displays the Program Information screen. You use this screen to enter the information Shell needs to start a specific program or execute a specific command. From the Shell menu, 1 Select Setup (4) to display the Setup menu. 2 Use the arrow keys or type a menu letter to move to the menu item you want to edit. or Move to an empty line if you are creating a new menu item. 3 Select Edit (1) or press Enter to display the Program Information screen. Shell will not let you edit a menu item that is currently resident in memory (resident programs are marked with an asterisk on the Shell menu). Use Down Arrow () or Tab to move forward through the Program Information settings, and use Up Arrow () or Shift-Tab to move backward through the settings. As you move through the settings, a Help message explaining each setting is displayed at the bottom of the screen. Press Help (F3) to display additional information about the Program Information screen or see Program Information Options in Shell Reference. 4 Edit or enter the program information for the menu item. 5 Press Exit (F7) to save any changes and return to the Setup menu. 6 Press Exit again to return to the Shell menu. Add Use this option to add (insert) a space for a new menu item. From the Shell menu, 1 Select Setup (4) to display the Setup menu. 2 Use the arrow keys or type a menu letter to move to where you want to insert a space for a new menu item. 3 Select Add (3). When you select Add, a space is inserted and any menu items below the space are moved down one space. There must be at least one empty space at the bottom of the Shell menu for Add to work. Also, Shell will not let you add a space with the cursor resting on a program that is resident in memory or if any programs below the cursor are resident in memory (resident programs are marked with an asterisk on the Shell menu). 4 If you selected Add just to move the existing items down one space, press Exit (F7) to return to the Shell menu. or If you selected Add to make room for a new menu item, follow steps 3 through 6 under Edit above to add the item. Delete Use this option to delete a menu item or menu item space. From the Shell menu, 1 Select Setup (4) to display the Setup menu. 2 Use the arrow keys or type a menu letter to move to the menu item or space you want to delete. 3 Select Delete (4) to delete the item and move all items below up one space. or Press Ctrl-End to delete the item and leave the space blank. You cannot use the Delete option with a menu item that is resident in memory or if any items below the cursor are resident in memory (resident programs are marked with an asterisk on the Shell menu). You are asked if you really want to delete this item. 4 Type y to delete the item. or Type n to cancel the deletion and return to the Setup menu. Important: When you delete an item, you also delete all the information on that item's Program Information screen. 5 Press Exit (F7) to save the changes and return to the Shell menu. You can press Cancel (F1), then type y to exit Setup without saving any changes. This will restore any menu items you deleted or modified since selecting Setup. Move You can use this option to move a menu item to a new location, create a duplicate menu item, or swap the locations of two menu items. When you move a menu item, the menu letter is also moved. From the Shell menu screen, 1 Select Setup (4) to display the Setup menu. 2 Use the arrow keys or type a menu letter to move to the menu item or space you want to move. 3 Select Move (5). 4 Type the letter to which you want to move, copy, or swap the item. If more than one location has the letter you type, Shell displays different letters for each of these locations and asks you to select a letter again. 5 Select Move (1) to move the item to the specified menu letter. or Select Copy (2) to create a duplicate of the item at the specified menu letter. or Select Swap (3) to swap the current item with the item at the specified menu letter. If you select Move or Copy and an item already exists for the specified menu letter, Shell asks if you want to overwrite that entry. Type y to overwrite (replace) the entry, or type n to cancel the move or copy command. 6 Press Exit (F7) to return to the Shell menu. Shell Feature Setup To change the default settings for Shell features, 1 Select Setup (4). 2 Select Options (2) to display the Options menu. 3 Select an option and make the necessary changes (the options are described below). 4 Press Exit (F7) to save the changes and return to the Shell menu. Any settings you change remain in effect until you change them again. Colors If you have a color monitor, this option lets you change the display colors for Shell (see Colors in Shell Reference for details). Date Shell displays the current date and time in the heading of the Shell menu. Use the Date option to change the display format of the date and time. 1 Select Date (2) from the Options menu. 2 Enter a new format string (up to 29 characters) using the special characters displayed on the screen. Include in the format string any text characters (such as spaces, commas, and colons) you want displayed with the date and time. Several examples of date formats are displayed on the Date Format screen. Menu Title The menu title is the title displayed in the heading of the Shell menu. To change the menu title, 1 Select Menu Title (3) from the Options menu. 2 Enter a new title (up to 30 characters). or Edit the existing title, then press Enter. If you edit the title, use Right Arrow () and Left Arrow () to position the cursor, and use Backspace and Delete (Del) to delete characters. Work Log Select this option to set up the Work Logging feature (see Work Log Setup in Shell Reference for details). Screen Save Leaving the same screen displayed for long periods of time can cause a ghost of that image to be etched in the monitor screen. If you leave the Shell menu (or submenus) on the screen for long periods of time, you can use Screen Save to protect your monitor screen. Screen Save causes the screen to go blank if no keystrokes are pressed within a specified time period. 1 Select Screen Save (5) from the Options menu, The «Screen save interval (minutes):» message appears. 2 Enter the number of minutes (0 to 255) you want to elapse before the screen goes blank. Enter 0 (zero) to turn off Screen Save. Password This option is designed primarily for the use of the system administrator. Using Password, the system administrator can set up the Shell menu for all users and then lock the menu with a password so it cannot be changed by users. If your system administrator has protected Setup with a password, you can still select Options from the Setup menu to change the Colors, Date, Menu Title, Log, and Screen Save settings. Select Setup (4), then press Enter when prompted for the Setup password. The message «ERROR: Invalid Password» appears, then the Setup menu is displayed. You can then select Options to display the Setup options (except Password and Go to DOS). If you do not know the password, Shell will not let you select Edit, Add, Delete, or Move from the Setup menu, even though these options are displayed. If Setup is not already password protected, you can assign a password of your own to protect your Setup settings from unwanted changes. 1 Select Password (6) from the Options menu. 2 Enter a password (up to 16 characters). The characters do not appear as you type them. For this reason, you are asked to re-enter the password to verify that you entered it correctly. 3 Re-enter the password. After you exit Setup, you will be prompted for the password each time you or someone else presses Setup. Important: Please note that if you forget the password, there is absolutely no way to access the Setup feature without completely recreating the Shell menu. If you want to later remove the password, 1 Select Setup (4) from the Shell menu screen, then enter the password to display the Options menu. 2 Select Options (2), then select Password (6). 3 Press Enter twice. 4 Press Exit (F7) to return to the Shell menu. Go to DOS This option (like Password) is designed primarily so the system administrator can decide whether the user should be allowed to use the Go to DOS option on the menu at the bottom of the Shell screen. To change the Go to DOS setting, 1 Select Go to DOS (7) from the Options menu. 2 Type y to turn on the Go to DOS feature. or Type n to disable the Go to DOS feature. (This is the default setting.) If you disable the Go to DOS feature and do not want the user to be able to turn the feature on again, be sure to assign a password to Setup (see Password above).█ Switch Program Using the Shell feature, you can switch programs (leave a program resident in memory while starting another) by returning to the Shell menu, then selecting another menu item or Shell feature. You can also use the Switch Program feature to switch directly from any program to any other program on the Shell menu or to any of the Shell options (such as Go to DOS or Memory Map). To use Switch Program, press Ctrl-Alt-x (where x is the letter you would type from the Shell menu to start the desired program or the number you would type to select the desired Shell feature). You can also press Switch to Shell (Ctrl- Alt-Space Bar) to simply return to the Shell menu. For example, to switch to Notebook from the current program, you would press Switch to Notebook (Ctrl-Alt-n if N is the menu letter for Notebook). To switch to Memory Map from the current program, you would press Ctrl-Alt-5. If a program on the Shell menu is not Shell-compatible (does not have a Shell feature), but does have a feature that lets you return to DOS without exiting the program, you can still use the Switch Program feature with that program by defining a Go to Shell macro (see Go to Shell Macro Name under Program Information Options in Shell Reference). You can also use the Alt-Shift-x keystroke to switch to a different program, as in earlier versions of WordPerfect Office. However, because the Alt-Shift keystroke is also used to start Shell macros, Shell looks first for a Shell macro assigned to that keystroke. If a Shell macro is found, Shell executes the macro. For this reason, we recommend that you always use the Ctrl-Alt keystroke to switch between programs. If no macro is found, Alt-Shift-x works the same as Ctrl-Alt- x.█ Work Log You can use the Work Log feature to keep track of the time you spend and the number of keystrokes you press when using Shell and programs running under Shell. Work Log Types You can create work logs that record the total time and keystrokes used for a specific project or client (project/client work logs), and work logs that record the total time and keystrokes used in specific programs (program work logs). Project/Client Work Log When you start a project/client work log, Shell starts a timer and begins recording keystrokes immediately. You can stop logging time and keystrokes for the current project by outputting (saving) the work log or by exiting Shell. When you output the work log or exit Shell, the timer and keystroke counter are reset for the next project/client work log. Program Work Log After you start program logging, Shell creates a separate work log for each program you start from Shell. The time and keystrokes for each program are recorded until you output the work log for that program or exit that program. For example, suppose you turn on program logging, and then you start and later exit Notebook, WordPerfect, and Calculator from the Shell menu. This will create three program work log records■one for Notebook, one for WordPerfect, and one for Calculator. Using Work Log Using the Work Log feature involves the three basic steps listed below. Follow the steps in the order they are listed. Setting Up Work Log Before you actually use the Work Log feature, you need to set it up with the Work Log Setup options. Use these options to indicate the name of the file where you want work logs saved, whether you want work logging to start as soon as you start Shell, and how often work log records should be backed up. See Work Log Setup in Shell Reference for detailed instructions on setting up the Work Log feature. Managing the Work Log Feature Use the Work Logging screen to manage the Work Log feature while Shell is running. You can start, stop, and pause work logs and enter information that identifies and describes each work log in the work log file. See Work Log Management in Shell Reference for detailed instructions on managing the Work Log feature. Using the Work Log File Work logs are recorded in a Notebook file that you can retrieve, edit, and print in Notebook or WordPerfect. You can also use the work log file in a WordPerfect merge. For instructions on how to use a work log file, see Work Log File in Shell Reference.█ Work Log File Shell comes with the WORKLOG.NB Notebook file which is specifically designed to store work log records. The Notebook list and record displays have already been set up in the file. To output work logs to the WORKLOG.NB file, you must enter the name and location of the file in the Work Log Setup screen (see Work Log Setup in Shell Reference). Retrieving the WORKLOG.NB File After you have output one or more work logs, you can retrieve the work log file to view them. To retrieve the WORKLOG.NB file into Notebook, 1 Start Notebook from the Shell menu. 2 If the words «Empty Notebook» do not appear at the top of the screen, press Exit (F7), then type n twice to clear the screen. 3 Press Retrieve (Shift-F10), then enter the full pathname of the WORKLOG.NB file (e.g., c:\nbfiles\worklog.nb). The list display shows selected fields (pieces of information) from each work log. To view all the fields for a specific work log record, 4 Use the arrow keys to move the cursor to the desired work log record, then press Enter. As shown in the screen above, there are 12 fields of information in a work log record. The Work Logging feature generates the information for the time period, elapsed time, program, keystrokes, and sort fields. You enter the project information, user information, and comments from the Work Logging screen (see Work Log Management in Shell Reference). You can edit and print the information in the WORKLOG.NB file the same as you would any other Notebook file (see Print in Notebook Reference). Worklog files are created in WordPerfect 4.2 format and must remain in that format for Shell to continue to use them. 5 When you finish with the file, press Exit. 6 If you made changes to the file and want to save them, type y, then press Enter to replace the original file with the edited version. or Type n if you do not want to save any changes made to the file. 7 Type y to exit Notebook. WORKLOG.NB Fields Each of the fields in the WORKLOG.NB file is described below. Project Information The Project Information box contains the Project ID and Project Type fields. These fields contain the information you entered with the Project and Project ID options on the Work Logging screen. User Information The User Information box contains the User ID and User Type fields. These fields contain the information you entered with the User ID and User Job Type options on the Work Logging screen. Time Period The Time Period box contains the Start and End fields. The Work Logging feature enters the date and time when you started the work log in the Start field and the date and time when you output the work log in the End field. You can change the way the date and time appear with the Date feature (see Shell Feature Setup under Setup in Shell Reference). Elapsed Time The Elapsed Time box contains the Time and Hours fields. The Time field contains the total time spent in standard hour- minute-second format. The Hours field contains the total time as a decimal number in case you want to perform calculations with the elapsed time (see Clipboard Calculations under Shell in Calculator Reference). For example, two hours, thirty minutes, and zero seconds would appear as 2.50 in the Hours field. Because you can pause the timer when logging a project, the total elapsed time for a project work log record may not equal the time between the start and end times. Program If the current record is a program work log, the name of the program appears in this field. If the record is a project record, «!(Summary)» appears in the Program field to expedite searching for and sorting project records. Keystrokes This field contains the number of keystrokes pressed for a project (project log) or while in a program (program log). The number only includes keystrokes pressed from within Shell or a program started from the main Shell menu. Sort The date and time in the Sort field is the same as the date and time in the End field in the Time Period box. However, the date is in a special format so the work log records can be sorted chronologically. For example, January 6, 1990, 1:26 p.m. is formatted as 1990/01/06 13:26. Only the year is displayed in the Sort field. You can scroll through the complete date by pressing Right Arrow (). Comments This field contains any comments you entered with the Project Description or Program Comments options on the Work Logging screen. Using WORKLOG.NB in a WordPerfect Merge Because Notebook files are in WordPerfect secondary merge file format (see Introduction to Notebook in Notebook Reference), you can use the WORKLOG.NB file in a WordPerfect merge. Included with Shell is a special macro and a WordPerfect primary merge file you can use to create a work log report in WordPerfect. See Appendix F: Editor and Shell Macros, Predefined for details.█ Work Log Management Once you set up the Work Log feature (see Work Log Setup in Shell Reference), you can begin to use Work Log. You control and manage the Work Log feature from the Work Logging screen. To display the Work Logging screen, select Log (6) from the Shell menu. You cannot display the Work Logging screen unless you have entered a work log filename in Setup (see Work Log Setup in Shell Reference). Your Work Logging screen will look similar to the screen below when you first select Log from the Shell menu. Use the options on this screen to enter identifying and descriptive information for work logs, to start work logs, to output work log records, and to back up work log records. Each of these Work Log management functions is described in the sections below. After using the Work Logging screen, press Exit (F7) to return to the Shell menu. Starting, Pausing, and Stopping Work Logs Use the Work Logging Status options (7 through 9) to start, pause, and stop work logs for projects and programs. (For an explanation of project and program work logs, see Work Log Types under Work Log in Shell Reference). Changes you make to these settings are changed back to the Work Log default settings each time you exit Shell (see Work Log Setup in Shell Reference). Use the Project Log and Program Log options to start and stop project logs and program logs. If you have both Project Log and Program Log active at the same time, separate work log records will be created for the current project and for each program you start under Shell. All work log records, however, will have the same Project/Client Information and User Information fields (see Entering Project/Client and User Information below). Project Log To change the Project Log setting, 1 Select Project Log (7) from the Work Logging screen. 2 Type y to start a new project log. or Type n to stop the currently active project log. If you typed n, Shell asks if you want to output the work log record. 3 Type y to output the project log record and reset the project log timer and counter. or Type n to reset the project log timer and counter without outputting the project log record. Important: If you reset the project log timer and counter without outputting the records, the currently active project log will be lost. Project Timer Use this option to pause the currently active project log. 1 Select Project Timer (8), then type n to temporarily turn off the project timer and keystroke counter. When you want to reactivate the project log, 2 Select Project Timer, then type y to turn on the project timer and keystroke counter. Program Log To change the Program Log setting, 1 Select Program Log (9). 2 Type y to turn on program logging. or Type n to stop all currently active program logs. If you typed n, Shell asks if you want to output the work log record(s). 3 Type y to output the program log record(s) and reset all program timers and keystroke counters. or Type n to reset the program log timers and counters without outputting the program log record(s). Important: If you reset the program log timer and counter without outputting the records, the currently active project log will be lost. Entering Project/Client and User Information Use these options (1 through 4) to identify a work log. The information you enter with these options is output as fields in the work log record. To use any of the first four options, 1 Select an option by typing the corresponding number. 2 Enter the desired text (up to 29 characters). When entering text for any of these options, you can use the following cursor movement and editing keys: 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 Word Ctrl-Backspace Delete to End of Line Ctrl-End Restore Original Text Cancel (F1) Project and Project ID For Project and Project ID, enter whatever you think identifies the project best. For example, if you are creating a log of the work you do on a pretrial summary for the Marquez vs. Lipton case, you might enter the following: Project: Marquez vs. Lipton Project ID: Pretrial Summary Project and Project ID are cleared (reset to [NONE]) when you exit Shell. User and User Job Type Use the User and User Job Type options to enter information about the person doing the work. For example, User: Jackie Chang User Job Type: Attorney User and User Job Type are cleared (reset to [NONE]) when you exit Shell. Changing Project/Client or User Information If you enter or change information in the Project, Project ID, User, or User Job Type fields after starting a work log, and the work log is still active when you attempt to exit the Work Logging screen, you are warned that information in one of these fields has changed and asked if you want to output all records with previous values. Type y to output all currently active work log records with the original text in the Project, Project ID, User, and User Job Type fields. When the active project and/or program work log record(s) are output, Shell starts another project and/or program work log using the new values (text) in the Project/Client Information and User Information fields. Type n if you want to use the new Project/Client Information and User Information fields with the currently active work log(s). If you type n, Shell does not output any work log records and does not start any new work logs. Adding Descriptions and Comments The text you enter for Project Description or Program Comments appears in the Comments field of the WORKLOG.NB file when you output the worklog record (see Work Log File in Shell Reference). For Program Comments, Shell automatically outputs any text on the Startup Options line for the program being logged (see Program Information Options in Shell Reference) to the Comments field in the WORKLOG.NB file. A space is added to the end of the startup options to separate them from any comments you may enter. You can use the same cursor movement and editing keys listed under Entering Project/Client and User Information above when entering comments. Project Description You can only enter text for Project Description when a project log is active (when the Project Log setting on the Work Logging screen is Yes). Shell displays an error message if you select Project Description when there is no project log active. To add a description to the currently active project log, 1 Select Project Description (5). A pointer (>) appears on the line below the Program Comments line. 2 Type the description at the pointer. The Project Description field can hold up to 74 characters. 3 Press Enter to add a space at the end of the description. The cursor returns to the beginning of the Project Description line for you to enter more text. or Press Exit (F7) to add a space at the end of the description and exit the Project Description line. or Press Ctrl-Enter to add a hard return to the end of the description and exit the Project Description line. Program Comments You can only enter text for Program Comments when at least one program log is active (when the Program Log setting on the Work Logging screen is Yes). Shell displays an error message if you select Program Comments when there is no program log active. To add comments to a currently active program log, 1 Select Program Comments (6). You are prompted for the Shell menu letter of the program. The most recently started program is displayed at the prompt as the default. 2 Press Enter to enter comments for the default program. or Type the letter of another currently active program. If you type a menu letter for a program that is not active, Shell displays an error message and exits the Program Comments option. 3 Type the comment at the pointer. The Program Comments field can contain up to 74 characters. 4 Press Enter to add a space at the end of the comment. The cursor returns to the beginning of the Program Comments line for you to enter another comment. or Press Exit (F7) to add a space at the end of the comment and exit the Program Comments line. or Press Ctrl-Enter to add a hard return to the end of the comment and exit the Program Comments line. Outputting Work Log Records If you exit a program while program logging is active, Shell outputs that program log record. If you exit Shell while a project log is active, Shell outputs that project log record. There are also several ways to output records manually. Shell gives you the option of outputting all currently active work log records when you change a Project/Client Information or User Information field (see Entering Project/Client and User Information above) and when you turn off program or project logging (see Starting, Pausing, and Stopping Work Logging above). The Force Record Output options on the Work Logging screen let you output all or selected records at any time. Select All Records (a) or press Output All Records (F9) to output all currently active work log records to the work log file. Select Project Record (r) to output only the currently active project work log. Select Program Records (s) to output only currently active program logs. As soon as you output an active work log, the timer and keystroke counter are reset, and a new work log is started. To output a work log without starting a new one, use the Work Logging Status options (see Starting, Pausing, and Stopping Work Logs above). Backing Up Work Logs You can periodically back up work log records by pressing Backup Current Record(s) (F10) from the Work Logging screen. This guards against losing work log records due to machine or power failure. When you back up work logs, temporary records are created in the work log file and are updated each time you press Backup Current Record(s). The temporary records are replaced when you output the work log records. You can also have Shell back up work log records at timed intervals by turning on Timed Backup in the Work Logging Setup screen (see Work Log Setup in Shell Reference). Temporary and Permanent Records When you are saving a Notebook file, Notebook treats temporary records created by the Backup feature the same as permanent ones. If you edit your work log file in Notebook and save the changes while there are temporary records in the file, you will probably end up with duplicate work log records (one created from the Backup feature and one created when the work log is output). For this reason, you should always output your work log records before editing a work log file in Notebook (see Work Log File in Shell Reference).█ Work Log Setup Before you use the Work Log feature, you need to enter the name of the work log file and make sure the settings are correct in the Work Log Setup menu. Locating the Work Log File Work logs are saved in Notebook file format (see Work Log File in Shell Reference). WordPerfect Office comes with a special Notebook file called WORKLOG.NB designed specifically for storing work logs. The WORKLOG.NB file should be in the same directory as the Shell program file (SHELL.EXE). If it is not, consult your system administrator. When you find the WORKLOG.NB file, copy it to your local hard disk or to a personal network directory. Do not change the filename. Setting Up Work Log To set up the Work Log feature, 1 Select Setup (4) from the Shell menu, then select Options (2). 2 Select Log (4) to display the Work Logging Setup screen. When you first enter the Work Logging Setup screen, the cursor rests on the Work Logging Filename option. 3 Enter the full pathname of the WORKLOG.NB file you copied to your hard disk or personal network directory. Important: Do not enter the pathname of the original WORKLOG.NB file. The original must remain unchanged so all users can copy from it. After you enter the filename, the cursor moves to the Project Logging setting. 4 Type y if you want a new project log started each time you start Shell. or Type n if you want to start project logs manually from the Work Log screen (see Work Log Management in Shell Reference). The cursor moves to the Program Logging setting. 5 Type y if you want program logging started when you start Shell. or Type n if you want to start program logging manually from the Work Log screen (see Work Log Management in Shell Reference). The cursor moves to the Timed Backup setting. 6 Type y if you want Shell to back up your active work logs at timed intervals (see Timed Backup below). or Type n to turn off Timed Backup. The cursor moves to the Timed Backup Period setting. If you typed n in step 6 above, skip to step 8. Otherwise, 7 Enter the number of minutes (1 to 255) you want to elapse between each backup of active work logs. (If you enter 0 or a number over 255, Shell does not back up work logs, even if the Timed Backup setting is Yes.) The Timed Backup Period setting is ignored if the Time Backup setting is No. 8 Press Exit (F7) twice to save the settings and return to the Shell menu. Timed Backup If you use the Timed Backup feature, each time you return to the Shell menu, Shell checks to see if the amount of time indicated for Timed Backup Period has passed since the last backup. If it has, Shell backs up all active work logs. If it hasn't, the records are not backed up. Backup records are temporarily output to the work log file. These records are replaced when you output the work logs (see Work Log Management in Shell Reference). Editing Work Log Setup You can change the Work Log Setup settings at any time by repeating the steps under Setting Up Work Log above. While in the Work Log Setup screen, you can use Down Arrow () or Up Arrow () and Tab or Shift-Tab to move forward or backward through the settings.█ Appendix I: Error Messages The WordPerfect Shell program will occasionally display error messages to let you know that there is a problem with the procedure you are trying to perform. Many error messages are self-explanatory; however, this appendix includes those messages which may need more explanation. These error messages are listed alphabetically. If you are running Shell on a network and encounter a message that is not listed here, it could be a network software error message or a DOS error message. Talk to your system administrator or check your DOS manual for an explanation of these messages. «Cannot create clipboard virtual file» This message (along with «Cannot write to clipboard virtual file») will appear if you try to save or append more to the clipboard than the buffer will allow (the default amount of information the buffer can contain is 1K) and there is no room on the disk containing the overflow. If you get this message, you should use the /d-pathname startup option (see /d- pathname under Shell in Appendix P: Startup Options) to direct your overflow files to a directory you know you have rights to and you know has enough room. «Cannot transfer control to Shell» When you exit Shell with programs resident, you are asked if you want to save the information in all the programs. If you type y at this prompt, Shell takes you into each program to save the information. If you decide to do some editing while in a program, then try to return to Shell by pressing Shell (Ctrl-F1), you will receive this message. You must exit each program while exiting Shell. «No Log filename defined, must setup first» This message appears if you select Log (6) from the Shell menu without first setting up a filename for the Work Log feature. You must first set up the Work Log feature (see Work Log Setup in Shell Reference). «Problem reading the overlay file» The Shell program includes two program files■SHELL.EXE and SHELL.OVL. The second file is the overlay file. If Shell encounters a problem reading this file, you will see this error message, Shell will not run, and you will be exited out of the program. This usually occurs when the files are not found or the dates do not match (the SHELL.EXE was updated and SHELL.OVL was not). If this happens, contact your system administrator. The Shell program files will probably need to be reinstalled. «Submenu w/ unswapped program(s)» You will see this message in conjunction with the «To use this program, you must first exit...» message. As you switch between programs using the Shell Switch to Program feature, the programs you aren't using are kept in expanded memory. When that memory is filled, Shell starts using the conventional memory in your computer. The message appears if the program in conventional memory is in a submenu. You need to return to the submenu and exit that program.█ Appendix O: Shell, Macro Conversion The file format used for Shell macros in WordPerfect Office 3.0 is different from the one used in previous versions. The Shell Macro Conversion Program will, however, convert macros written with previous versions of WordPerfect Office so they will run with version 3.0. To convert a Shell macro with the Shell Macro Conversion Program, 1 Go to DOS. 2 Change to the directory where SHMACNV.EXE is located (usually the WordPerfect Office program directory). 3 Enter shmacnv macro name (where macro name is the name of the macro to be converted) to start the program and the macro conversion. (Be sure to enter the full pathname of the macro if it is not in the current directory. You need not enter the .SHM extension.) When the conversion is finished, «Done» appears on the screen. During the conversion, the extension on the original macro file is changed to .S20. The output file generated in the conversion has the same name as the original macro file, except it has a .SHM extension. The new macro file is stored in the same directory as the original file, which remains intact (except for the extension change). For example, if you converted a macro named FOOT.SHM, the original macro would be renamed FOOT.S20, and the converted macro would be saved as FOOT.SHM. Both files would be in the directory FOOT.SHM was in before the conversion. When the name of the original macro file is changed and a file with that name already exists in the directory, you will be asked whether you want to replace the file. You may either replace it or enter a different name for the original macro file. Multiple Files If you want to convert several macro files at once, you can use wild card characters (a question mark (?) to represent a single character, an asterisk (*) to represent zero or more characters) in the name of the macro file to be converted. For example, search? Converts all macros named SEARCH followed by a single character. search* Converts all macros named SEARCH followed by zero or more characters. * Converts all macros in the directory. Startup Options There are two startup options you can use with the Shell Macro Conversion Program. /h This option displays helpful information about the program. To use the option, enter shmacnv/h at the DOS prompt. /o This option causes existing .S20 files to be overwritten by renamed original macro files without a warning prompt. To use the option, enter shmacnv/o at the DOS prompt.█ Appendix P: Startup Options Several options can be included when you start the Shell program. Enter any of these options when you start the Shell from the DOS prompt (e.g., shell/n/m=colors/ns) or include them with the SHELL command in your AUTOEXEC.BAT file. For details on creating an AUTOEXEC.BAT file, see AUTOEXEC.BAT File in Appendix B: DOS and WordPerfect Office. Only four of the startup options (filename, /l, /m, and /n) can be used from under Shell, and only then if you are loading a submenu of Shell. filename The filename option loads the program, then immediately retrieves the Shell menu specified by filename to the screen. /c-n The /c-n option allocates a minimum of 1K and a maximum of 5K of memory to the clipboard. The n represents the amount of memory in kilobytes (1K = 1024 bytes). The default amount allocated to the clipboard is 1K. /d-pathname The /d-pathname option redirects all temporary files for the Shell program to the directory indicated by pathname. /l The /l option displays the Work Logging screen immediately after you start Shell. /m-macro name The /m-macro name option executes the Shell macro specified by macro name as soon as Shell starts. /n The /n option starts Shell, but does not start any programs set to start resident. /ne The /ne option starts Shell, but any available expanded memory is not used. If you do not use this option or the /v option, Shell makes full use of any available expanded memory. /nf The /nf option must be used with some compatibles and windowing programs (other than TopView). This is the «non- flash» (not fast) version of Shell and should be used if text is displayed over the window or if the screen goes blank from time to time. /no The /no option causes Shell to use only the available conventional memory (the first 640K of RAM) for switching between programs. /ns The /ns option starts the non-sync version of Shell by inhibiting synchronization of output to color monitors. It speeds up display on color monitors, but may cause snow on some. /nt-x The /nt-x option lets you specify a network type where x is the network number or letter WordPerfect Office uses to identify a specific network software. See your system administrator if you need to use this option but do not know the number or letter of your network software. /o-[limit];path[limit];path[limit] The /o-[limit];path[limit];path[limit] option causes Shell to use available expanded memory, RAM drive, and/or hard disk space when switching between programs. It also lets you specify the location of and limit (in kilobytes) the use of each of these resources. If you do not use this option, Shell uses all available expanded memory and all available disk space on the drive from which you are running Shell. The portion of this option following the dash is divided into three parts, separated by semicolons. Use of each of the three parts is optional. If you want to limit the use of expanded memory, specify a limit within brackets immediately after the dash (i.e., /o-[limit]). If you include one or both of the next two parts, each must include a path. Enter the path to a RAM drive or to a hard disk for each part. You have the option of specifying a limit for each drive. /ss-rows,columns The /ss-rows,columns option lets you specify the number of rows and columns you want displayed on the screen. Generally, Shell automatically detects the correct number of rows and columns. However, with some monitors it is unable to determine the number of rows. This option lets you specify the correct number of rows for your monitor. /v-path[limit];path[limit] The /v-path[limit];path[limit] option causes Shell to use RAM drive and/or hard disk space only (no expanded memory) for switching between programs. (If you do not include the information following the dash, Shell uses the drive from where you are running Shell.) It also lets you specify the location of and limit (in kilobytes) the use of each resource specified. For each path, enter the path to a RAM drive or your hard disk. You have the option of specifying a limit for each drive. /w-xx The /w-xx option lets you allocate more memory than normal for executing Shell macros. The xx specifies the amount of memory allocated for Shell macros in kilobytes (1K = 1024 bytes). The default amount the program uses is 3K. You can enter a minimum of 2K and a maximum of 30K.