SHEZ The Compression Companion Copyright (c) 1989-1994 Release 10.9 California Software Design September 5, 1995 By: Jim Derr TABLE OF CONTENTS Page -2- ADDITIONAL PROGRAMS NEEDED (4) QUICK START (6) COMMAND LINE OPTIONS (8) MOUSE SUPPORT (9) ZOOMING DIRECTORY WINDOW WITH MOUSE (10) USING THE MOUSE WITH VERN BUERG'S LIST PROGRAM. (15) INTERNAL QUICK-VIEWER (15) EDITING KEY DEFINITIONS (15) FUNCTION SUPPORTED WHEN A DOS DIRECTORY WINDOW IS DISPLAYED (16) NOTES ON CREATING SFX FILES (18) FUNCTIONS WHEN VIEWING CONTENTS OF ARCHIVE FILE: (28) OPTIONS AVAILABLE ONLY VIA THE MENU SYSTEM (39) VOLUME LABEL SUPPORT (41) FLOATING EXTRACT LOCATION (41) Ultravision Support (42) FORMATTING FLOPPIES (42) KEYSTROKE RECORDING/PLAYBACK FACILITY (43) CREATING NEW COMPRESSED FILES (46) CONVERTING FILES (47) SUPPORT FOR SELF EXTRACTING FILES (48) ENVIRONMENT VARIABLES (49) SETTING ALTERNATE FILE VIEWERS (51) SETTING USER DEFINED PRINTER (51) SETTING UP USED DEFINED MENU ENTRIES (51) PERFORMING A VIRUS SCAN (51) VIRUS SCANNING A DIRECTORY (52) THE SGREP PROGRAM (54) THE DUMPMAC PROGRAM (56) THE SHEZCFG PROGRAM (57) TABLE OF CONTENTS Page -3- CONFIGURING FOR VIRUS SCANNING (57) COMPATIBILITY ISSUES (57) DESQVIEW COMPATIBILITY (58) WINDOWS AND OS/2 COMPATIBILITY (58) SWAPPING SHEZ OUT OF MEMORY (59) USING EMS/XMS MEMORY IN SHEZ (59) SPEECH FRIENDLY INTERFACE (61) 4DOS AND NDOS SUPPORT (61) USING 4DOS INTERNAL LIST COMMAND (62) SUPPORT FOR SPANNED ZIP FILES (63) SUPPORT FOR UC2 COMPRESSED FILES (63) SUPPORT FOR WINDOWS TYPE COMPRESSED FILES (63) SUPPORT FOR INFOZIP ZIP AND UNZIP (64) WHERE TO FIND THE MOST CURRENT VERSION (65) OVERSEAS AGENT (65) SUPPORT FOR SHEZ AND QUESTIONS (67) COMMANDS SORTED BY DESCRIPTION (68) CORPORATE SITE LICENSING FOR SHEZ (70) APPENDIX - 1 - ERROR CODES (71) CRITICAL SYSTEM ERROR CODES (73) APPENDIX - 2 - SHEZ.INI FILE (74) INDEX (80) SHEZ USER MANUAL Page -4- LIMIT OF LIABILITY SHEZ is distributed as-is. The author disclaims all warranties, expressed or implied. The author will assume no liability for damages either from the direct use of this product or as a consequence of the use of this product. SHEZ is a shell program to make viewing and working with archive files user friendly. It provides the user with a friendly, consistent interface for all supported compressed file operations. ADDITIONAL PROGRAMS NEEDED You will need, at a minimum, at least one file compression program, and optionally a file browser program. Vern Buerg's LIST program is an excellent, full featured file browser program, and has been thoroughly tested with SHEZ. You will also need one of the file compression programs supported by SHEZ. These include PKZIP, PAK, ARJ, LZH or LHA, PKPAK, ZOO, SQZ, UC2, and RAR. When installing these required programs, be sure to install them into a directory that is in your path statement. If you are installing the PKZIP package be sure to install the following three programs: PKZIP.EXE, PKUNZIP.EXE, and ZIP2EXE.EXE. All of the programs mentioned in this section, with the exception of Central Point Software Virus Scan, can be found on most Bulletin Boards, and on Cserve. They are all available on the Directory Assistance BBS that is mentioned at the end of this document. PKZIP, PKUNZIP by Phil Katz for ZIP files. PKUNPAK, PKPAK by Phil Katz for ARC files. LHARC, LHA by Haruyasu Yoshizaki for LZH files. ZOO by Rahul Dhesi for ZOO files. PAK by NoGate Consulting for PAK files. ARJ by Robert Jung for ARJ files. PKWARE, INC. LIST.COM by Vernon Buerg 7545 N Port Washington Rd. 139 White Oak Circle Glendale, WI. 53217 Petaluma, CA. 94952 (707) 778-8841 - BBS PAK by NoGate Consulting ARJ by Robert Jung P.O. Box 88115 2606 Village Road West Grand Rapids, Mi 49518-0115 Norwood, Mass. 02062 If you want to use the virus scan option of SHEZ you will also need the virus scan program by McAfee Associates called SCAN.EXE. The SCAN program from McAfee Associates has been extensively tested with SHEZ and is highly recommended. This program can be found on most major BBS's or you may obtain it by calling the McAfee BBS. You must obtain version 39 or greater of this program in order for SHEZ to use it correctly. SHEZ USER MANUAL Page -5- McAfee Associates 4423 Cheeney St. Santa Clara, Ca. 95054 (408) 988-3832 BBS (408) 988-4004 The virus scanning program from Central Point Software has also been tested with SHEZ. SHEZ USER MANUAL Page -6- QUICK START Installing SHEZ is a very straight forward procedure, simply copy or extract from the compressed file, all the .EXE, .COM, and the SHEZ.HLP files into a directory that is defined in your DOS PATH. Optionally you may create a new directory to hold the SHEZ files. If you choose this option you must either add the new directory name to your DOS PATH, or ALWAYS start SHEZ from the new directory. After installing the files run the SHEZ configuration program. At the DOS prompt type in SHEZCFG and press the enter key. The configuration program is menu driven with full help screen available for each option. THE SHEZCFG PROGRAM MUST BE USED TO CREATE AN EXTERNAL CONFIGURATION FILE. SHEZ WILL NOT RUN WITHOUT A CONFIGURATION FILE!!!!! To start-up SHEZ simply enter "SHEZ [d:\path\filespec]". You may specify wild cards in the filespec. If you use wild cards in the filespec SHEZ will present you with a scrollable list of files that it found matching the filespec. SHEZ recognizes the special filename.fileext of $.$. If you specify a filespec of $.$ SHEZ will list only the files having an extension of .ARC, .ZIP, .LZH, .ARJ, .ZOO, .SQZ, RAR, and .UC2 or the files having extension matching the extensions that where set using the configuration program. SHEZ will also recognize just the $ file extension along with a DOS wildcard filename. For example if you start SHEZ by entering SHEZ C:\UTY\P*.$ SHEZ will display a list of files that have a filename beginning with the letter P and that have a file extension of .ARC,.ZIP,.LZH,.ZOO,.PAK,.ARJ.SQZ.RAR,UC2, or what ever you set the extensions to using the config. program. You may also start SHEZ and specify a sub-directory name of the directory you are currently in. For example, if you are currently in the C:\UTILITY directory and you want to work on the files in the C:\UTILITY\PGMS directory start SHEZ by entering the following: SHEZ PGMS\ Also included in the file list will be any directories that SHEZ found. The directory names will be enclosed in greater than and less than symbols. I.E. . You can position the highlight bar on a directory name and press the enter key to view the files and directories that are contained in that directory. To move up one level in the directory tree highlight the directory entry that appears as <..>. As you change directories the full disk:\pathname will be displayed on the main screen. In addition the disk:\path that will receive extracted files is also displayed on the main screen. You can than choose the file you wish to work on by moving the highlight bar with the cursor keys and pressing the enter key. SHEZ will then present you with a screen showing the contents of the archive file. To perform a function, simply position the highlight bar and press the key(s) that corresponds to the function you want to perform on that member. Pressing the F1 key will open a window giving you context sensitive help. SHEZ also has a built-in menuing system. To activate the menu system press the forward slash key. A menu bar will appear at the top of the screen. Using the left and right cursor keys you may select major menu SHEZ USER MANUAL Page -7- item. Press the enter key to view the choices under the menu item. Using the up and down cursor keys you may choose an action item and then press the enter key to perform that item. Pressing the ESC key will take you back one level. Keep pressing the ESC key to exit the menu system. The menu system can also be navigated using the highlighted "HOT KEYS". The hot keys will appear in reverse video colors. The top menu bar will have the hot key highlighted. The drop down menus hot keys will also be highlighted and will appear on the left side of the drop down menu box. Below is an example of the menu display. On the top menu bar the hot keys appear as capital letters or numbers. View Cnvt Misc File Dirs mAc Opts ÕÍÍÍÍÍÍÆÍÍÍÍÏÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͸ ³ <..> ³0³~-V ³Convert the highlighted file³ ³ SHEZ ³1³^-V ³Convert all Tagged files ³ ³ SHEZC³2³F8 ³CVT highlighted file to SFX ³ ³ SHEZ1³3³S-F8³CVT tagged file(s) to SFX ³ ³ SHEZ1³4³A-F8³UUENCODE hilighted file ³ ³ ³5³C-F8³UUDECODE hilighted file ³ ³ ÔÍÍÍÍÍÍÍÍÍÍÍ[^=CTL ~=ALT]ÍÍÍÍÍÍÍÍÍÍ; There are two functions that can only be activated via the menuing system. Printing a file contained in an archive file, and setting the default compressing factor. There are no hot keys associated with these functions. SHEZ will optionally swap 90% of its code out of memory when you: 1) Shell to DOS 2) Execute the edit function. 3) Run a program contained in a compressed file. This allows you to run most programs from within SHEZ without running out of memory. The default for SHEZ is not to use this swapping function. However this can be changed via the configuration program. The swapping function will swap as much of SHEZ as possible out of DOS memory and into either EMS (3.2 or 4.0), XMS memory, if available, or to the currently active default disk. PLEASE NOTE: IF YOU ARE RUNNING A SYSTEM WITHOUT A HARD DISK OR WITHOUT EMS or XMS MEMORY DO NOT ACTIVATE THIS OPTION. SHEZ USER MANUAL Page -8- COMMAND LINE OPTIONS The command line format when starting SHEZ is as follows: SHEZ [filespec] [/Exxx] [/PLAY=xxx] [/LCD] [/Cfilespec] [/4] Please note all command line options are optional. You may enter a filespec pattern for SHEZ to use when searching for a file. All legal DOS wild card specifies are allowed, as are Drive and Directory information. In addition relative pathnames may also be entered on the command line. For example: SHEZ C:\UTY\*.ZIP This will startup SHEZ and will only list the files on the C: drive in the UTY directory that have a file extension of .ZIP. SHEZ ..\DATA\*.* This will startup SHEZ and will list the files one directory back from the \DATA directory. The /E parameter tells SHEZ to set its default extract location to the Drive and directory specified immediately following the /E parameter. DO NOT ENTER A SPACE AFTER THE /E parameter. I.E. /EC:\WORK This specifies an extract location of the E: drive and the WORK directory. If you start SHEZ with this parameter it will over-ride all other default extract location. Once SHEZ is started you may alter the extract location by using the ALT-P command. The /LCD parameter tells SHEZ you are running SHEZ on an LCD display monitor. SHEZ will adjust its screen color set to make the display more readable on LCD displays. The /PLAY= parameter tells SHEZ to load the previously saved macro file and playback the recorded keystrokes immediately upon startup. If the macro file does not exist, SHEZ will ignore the request. Example: SHEZ C:\UTY\*.ZIP /PLAY=C:\DATA\MY.MAC This will start SHEZ looking in the C:\UTY directory for all files with an extension of .ZIP and will playback the recorded keystrokes contained in the file C:\DATA\MY.MAC. For more information on keystroke recording and playback see the section KEYSTROKE RECORDING/PLAYBACK FACILITY on page 43 later in this document. The /C parameter allows you to specify the location of the SHEZ configuration file on the command line. The filespec immediately following the /c will be used as the configuration file. This will over-ride the SHEZCFG environment variable if it has been specified. The /4 parameter allows you to activate the 4DOS description display via the command line. SHEZ USER MANUAL Page -9- MOUSE SUPPORT Shez offers full mouse support in any of it's supported screen modes. When mouse support is active a mouse action bar will appear on the last line of the display. LEFT-MOUSE-BUTTON Pressing or releasing the left mouse button on one of the action items will perform the action as described below. If there is a Yes under the REPEATABLE column, this indicates that the action will repeat as long as the left mouse button is held down. All the actions shown on the action bar are active anywhere within SHEZ. ACTION-ITEM ACTION WHEN REPEATABLE? [] Scroll-up Button-down Yes [] Scroll-down Button-down Yes [] Scroll-left Button-down Yes [] Scroll-right Button-down Yes [PUp] Page-up Button-down Yes [PDn] Page-down Button-down Yes [Enter] Enter-key Button-release No [Esc] Escape-key Button-release No [MM] Mouse-Menu Button-release No [Sp] Space-key Button-down Yes [Y] Y-key Button-release No [N] N-key Button-release No [F9] F9-key Button-release No [Help] Help Button-release No [Home] Home-key Button-release No [End] End-key Button-release No [Exit] Exit-Shez Button-release No [Tab] Tab-key Button-release No In addition any item on the function key line can be selected by positioning the mouse cursor on the desired function key and pressing and releasing the left mouse button. RIGHT-MOUSE-BUTTON Pressing and releasing the RIGHT mouse button is the same as pressing the ESC key. ACTIVATING THE MENU SYSTEM To activate the normal menu system in SHEZ, move the mouse cursor to the top line of the display and press and release the LEFT mouse button. The normal menu bar will appear after releasing the button. The mouse cursor may now be positioned over any of the menu items, and pressing and releasing the LEFT mouse button will cause the selectable menu box to appear. When a drop down menu box appears you may then position the mouse cursor on a menu item. Pressing and releasing the LEFT mouse button ONCE will cause the menu item to be highlighted. Pressing and releasing SHEZ USER MANUAL Page -10- the LEFT mouse button on a HIGHLIGHTED item will cause the indicated item to be executed. ZOOMING DIRECTORY WINDOW WITH MOUSE The DOS directory window can be zoomed to full screen width and unzoomed to normal mode. The ZOOM/UNZOOM the window using the mouse, position the mouse cursor to the [þ] located at the bottom left position of the windows and press and release the left mouse button. SHEZ USER MANUAL Page -11- NAVIGATING A SCROLLABLE DIALOGUE BOX USING THE MOUSE When a scrollable dialogue box appears the mouse cursor can be positioned on the scroll bars, or within the dialogue box to perform the following actions: 1) Scroll the box up and down. 2) Scroll the box right and left. 3) Move the highlight bar to an item. 4) Tag an individual item. The sample screen display below shows the areas of a scrollable dialogue box where the LEFT mouse button performs an action. ÕEÍÍE:\APPS\TC\ZIP\$.$ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ͸ ³ <..> <----Scroll-UP ³ SHEZ EXE 05/10/93 09:53 237264±<-+ ³ SHEZCFG EXE 05/10/93 08:42 59230± | ³ SHEZ89D ZIP 03/13/93 22:41 84419± | ³ SHEZ89S ZIP 04/26/93 07:44 260032± +--Page-UP-area ³ SHEZ90S ZIP 04/26/93 07:44 261740± | ³ SHEZ91S ZIP 05/10/93 10:07 291251± | ³ SHEZCD2 ZIP 02/19/93 07:10 199738± | ³ V V±<-+ ³ | |Û<----Position-indicator ³ |----------------------------------|±<-+ ³ +-------------------------+--------+± | ³ | ± +--Page-Down-area ³ | ± | ³ | ± | ³ | ± | ³ | ±<-+ ³ | <----Scroll-Down ÔÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ | ÍÍÍÍÍÍÍ; VV | || | ++---Mouse-Tag-area +Mouse-position-highlight-bar-area To move the highlight bar to an item, position the mouse cursor on the item and press and release the LEFT mouse button. Pressing and releasing the LEFT mouse button on a currently highlighted item performs the same action as pressing the ENTER key. To TAG/UNTAG an item, position the mouse cursor to the LEFT of the item and press and release the LEFT mouse button. To perform a PAGE-UP or PAGE-DOWN position the mouse cursor on the scroll bar either above or below the position indicator and press the LEFT mouse button. To scroll the items up and down position the mouse cursor on the Scroll-up or Scroll-down arrows and press the LEFT mouse button. Both paging and scrolling are repeatable. Holding the LEFT mouse button down will repeat the action until the button is released. MOUSE SELECTABLE ITEMS IN A DIALOG BOX SHEZ USER MANUAL Page -12- Some dialog boxes allow you to enter options via the mouse. When a dialog box has mouse selectable items they will appear on the bottom line of the dialog box enclosed in braces. To respond to the dialog box place the mouse cursor on one of the items enclosed in braces and press and release the left mouse button. ÕÍÍÍÍÍÍÍÍÍÍÍÍ[Sort by Name, Extension, Date, Size,orUnsort?]ÍÍÍÍÍÍÍÍ͸ ³Enter N,E,D,S,U or ESC to exit==> ³ Ô{UNEDS}ÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ;  ³ ÀÄÄThis is the mouse selectable area.] SHEZ USER MANUAL Page -13- ACTIVATING THE QUICK MOUSE MENU In addition to the normal menu system, SHEZ also contains a QUICK MOUSE MENU SYSTEM. This menu system contains a few frequently used commands that can be accessed quickly. There are three ways to activate the QUICK MOUSE MENU: 1) To display the MOUSE MENU, position the mouse cursor on the [MM] item on the mouse action bar at the bottom of the screen. Press and release the left mouse button and the MOUSE MENU will appear. 2) Press and hold the right mouse button, then press and hold the left mouse button, then release both bottons. 3) If you have a three button mouse press and release the middle mouse button. One of two mouse menu's will appear depending upon where you are in SHEZ. If the DOS directory window in displayed the first menu will appear, if you are looking at the contents of a compressed file the second menu will appear. MENU WHEN DOS DIRECTORY IS DISPLAYED ÕÍÍÍÍÍÍÍ[CHOOSE]ÍÍÍÍÍÍ͸ ³ View A File ³ ³ View FILE_ID.DIZ ³ ³ QuickView A File ³ ³ External Viewer ³ ³ Convert File ³ ³ Convert to SFX ³ ³ Copy File ³ ³ Move File ³ ³ Rename File ³ ³ Delete File(s) ³ ³ Convert Tagged ³ ³ Make Tagged SFX ³ ³ Copy Tagged ³ ³ Move Tagged ³ ³ Rename Tagged ³ ³ Specify Extract Path ³ ³ Create new ³ ³ Sort list ³ ³ Exit to Extract ³ ÔÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ; MENU WHEN LOOKING AT THE CONTENTS OF A COMPRESSED FILE ÕÍÍÍÍÍÍÍ[CHOOSE]ÍÍÍÍÍÍ͸ ³ View File ³ ³ QuickView File ³ ³ Freshen Files ³ ³ External Viewer ³ ³ Extract File ³ ³ Delete File(s) ³ ³ Add File ³ ³ Edit File ³ ³ Execute File ³ ³ Convert From SFX ³ ³ Extract All ³ ³ Extract Tagged ³ ³ Specify Extract Path ³ ³ Create New ³ SHEZ USER MANUAL Page -14- ³ Sort list ³ ³ Exit to Extract ³ ÔÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍÍ; When the mouse menu appears pressing and releasing the RIGHT button will cancel the mouse menu. To perform one of the item position the mouse cursor on the item to be performed and press and release the LEFT mouse button TWICE. SHEZ USER MANUAL Page -15- USING THE MOUSE WITH VERN BUERG'S LIST PROGRAM. I have had numerous questions on how to allow the mouse to function when viewing a file via Vern's list program. In order to allow the mouse to function within list you must "CLONE" the mouse option into the list program. You must be using LIST PLUS version 7.2 in order to use the mouse. To clone the mouse option change to the directory that contains the LIST.COM program, then start the LIST program from the DOS prompt and include the mouse command line option /M. I.E. LIST /M. When the first screen appears press ALT-C to modify LIST.COM to always startup with the mouse option. If you need further information on cloning the list program please see the documentation included with LIST. INTERNAL QUICK-VIEWER Shez also contains it's own internal file browser called QUICKVIEW. QUICKVIEW has full mouse support and will allow you to view any size file using a minimum of memory. While it is not substitute for a full featured browsing program such as Vern Buerg's LIST program, it is very fast and allows you to view any file in ASCII or HEX modes. If you don't have an external browsing program QUICKVIEW will allow you to use SHEZ as it was intended. EDITING KEY DEFINITIONS When you are prompted to enter information the following editing keys can be used: Home: Go to beginning of input line. End: Go to end of input line. Backspace: Go back one character and delete. CTL-END: Erase to end of line. Cursor Right: Move right one character. Cursor Left: Move left one character. ESC: Cancel input. SHEZ USER MANUAL Page -16- FUNCTION SUPPORTED WHEN A DOS DIRECTORY WINDOW IS DISPLAYED DOS directory Speed Search When the DOS directory window is displayed you may quickly position the highlight bar to a directory or file by pressing a single letter or number. Pressing an UPPER CASE A-Z or 0-9 will be position you to the first directory that begins with the pressed letter or number. Pressing the same letter or number again will position the highlight bar to the next matching entry. If no entry begins with the entered letter or number the highlight bar will not be moved. Pressing an lower case a-z or 0-9 will be position you to the FILES that begins with the pressed letter or number. Extract location - ALT-P This option will prompt you to enter a drive and directory of where to place files that you extract from the archive. This location will remain in effect until you enter the ALT-P command again and clear the drive and directory or you change to another archive file. This command is used when you want to place extracted files in a location other than the current drive and directory. If you specify a directory that does not exist a ERROR/INFORMATION window will appear indicating that the directory does not exist. You may press the F10 key to create the directory. This command may be issued at any time. When the input window appears pressing the F9 key will open another window which will display a scrollable list of directories. To display a list of directories other than on the current drive, enter the drive letter followed by a colon, then press the F9 key. Scroll the list using the up and down cursor keys, and press the ENTER key to select the directory you wish to extract files into. Create a new archive file - F7 This option allows you to create a new compressed file. For further information see the section titled, CREATING NEW COMPRESSED FILES on page 46. Show help screen - F1 This will display a help screen showing all currently supported commands. Any command can be entered while the help screen is displayed. Temporary exit to DOS - F10 This will temporarily clear the screen and exit to DOS. You can then execute and command you want. To return to SHEZ type in EXIT at the DOS prompt and press return. (Not available when running under DESQVIEW) Temporary exit to DOS into Extract Directory - ALT-F10 This will temporarily clear the screen and exit to DOS into the currently defined extract directory. You can then execute and command you want. To return to SHEZ type in EXIT at the DOS SHEZ USER MANUAL Page -17- prompt and press return. (Not available when running under DESQVIEW) Select a new archive file - F2 This option will prompt you to enter a new disk, directory, and filespec to find another archive file to work with. If you enter a filespec of $.$ SHEZ will only list directory entries and file that have extensions of .ARC, .ZIP, .LZH, PAK, ARJ, ZOO, SQZ, RAR, and UC2. When the input window appears pressing the F9 key will open another window which will display a scrollable list of directories. To display a list of directories other than on the current drive, enter the drive letter followed by a colon, then press the F9 key. Scroll the list using the up and down cursor keys, and press the ENTER key to select the directory you wish to change to. View a file - F3 This option will allow you to view any file that is listed in the main file window. Simply highlight the file you wish to view by using the cursor keys then press the F3 key. The list program will be invoked allowing you to view the contents of the file. (ALSO SEE CTL-ENTER FOR ALTERNATE FILE VIEWERS) Delete a DOS file or empty directory - F4 This option allows you to delete the file that is currently highlighted in the file window. Please note will be asked if you want to delete the file. Respond Y if you wish to delete the file, anything else will abort the delete. The deleted file name will not be removed from the displayed list. Instead it will be flagged with an # to the left of the filename and a 'd' to the right. If the highlighted entry is a directory, SHEZ will remove the directory only if there are no files or sub-directories under this directory. Sort the file list - F9 This option will sort the file list that appears on the left side of the screen. You will be asked if you want the list sorted by filename, file extension, file date, file size, tagged status, or unsorted. When sorting by filename any directory found will also be sorted. When sorting by extension, date, or size the directories will be sorted at the top of the list. When sorting by date the file time is also included in the sort. A dialog box will also appear asking you if you wish to sort in Ascending or Descending order. SHEZ USER MANUAL Page -18- Convert highlighted file - ALT-V This option will convert the highlighted file to another archive method. A list will appear showing the available compression alternatives that SHEZ has been configured for. Using the mouse or cursor keys highlight the compression method you wish to convert to, then press the enter key. You may also press the ESC key to cancel the conversion process. The converted file will be placed into the same directory as the original file, and the original file will remain intact. When a compressed file also has directory information stored along with the filenames, and the file is being converted to a compression method that supports pathnames, SHEZ will retain the directory information. In addition, if the compressed files being converted has volume label information stored, SHEZ will attempt to retain the volume label information. (PLEASE NOTE: THE VOLUME LABEL PROCESSING WILL ONLY WORK IF YOU ARE CONVERTING FROM A ZIP OR ARJ FILE FORMAT TO A ZIP OR ARJ FILE FORMAT. ALSO THE VOLUME LABEL PROCESSING WILL NOT FUNCTION WHEN RUNNING SHEZ IN THE DOS BOX UNDER OS/2.) Convert all tagged files - CTL-V This option will convert all tagged files to another archive method. A list will appear showing the available compression alternatives that SHEZ has been configured for. Using the mouse or cursor keys highlight the compression method you wish to convert to, then press the enter key. You may also press the ESC key to cancel the conversion process. The converted file will be placed into the same directory as the original file, and the original file will remain intact. Convert highlighted file to a SFX file - F8 This option will convert the highlighted compressed file into a Self extracting file. (Currently only files in the ZIP,LZH, and PAK formats may be converted) If you are converting a ZIP file that was created using version 1.1 of PKZIP, SHEZ will first attempt to create a MINI Self extracting file. If that fails than a normal Self extracting file will be created. See the PKZIP documentation for more on MINI self extracting files. NOTES ON CREATING SFX FILES To convert a ZIP file to self extracting file the program, ZIP2EXE.EXE, must be in the current directory or in a directory that is defined in your PATH. When a PAK file is converted the PAK file is replaced by the self extracting file. For example: If tell SHEZ to convert a file named TEST.PAK in the directory C:\TEST the TEST.PAK file will be deleted from the C:\TEST directory and will be replaced by the file TEST.EXE. This is not a function of SHEZ it is a function of the PAK compression program. When an LZH file is converted to a self extracting file the LHARC program will created either a .COM file or a .EXE file, depending on the size of the LZH file. SHEZ USER MANUAL Page -19- Convert Tagged files to SFX files - SFT-F8 This option will convert all tagged compressed files into Self extracting files. See the F8 option above for additional information on creating SFX files. Write out configuration information - ALT-W This option will write out a file named SHEZ.CFG. This file will contain the current SHEZ configuration options. This file can then be used as your default configuration file. This file should be copied to a directory that is named in your path statement. Copy highlighted file CTL-F2 This option allows you to copy the highlighted file. When prompted for the location to copy to you may enter the target directory name along with an optional filename and extension. If the filename and extension are not supplied SHEZ will use the original filename and extension. You may also use the * wildcard character for either the filename and/or the extension. If you use the * character SHEZ will use the original filename and/or extension when copying the file. I.E. From: = C:\UTILITY\ANY.ZIP To: = C:\WORK\NEW.* This will create a file named NEW.ZIP in the \WORK directory. The new file will have the original file's time and date stamp. Move highlighted file CTL-F3 This option allows you to move the highlighted file. When prompted for the location to move to you may enter the target directory name along with an optional filename and extension. If the filename and extension are not supplied SHEZ will use the original filename and extension. The moved file name will not be removed from the displayed list. Instead it will be flagged with an # to the left of the filename and a 'm' to the right. If you move a file from one directory to another directory on the same drive, SHEZ will simply modify the file pointers instead of performing a copy and delete function. Rename highlighted file CTL-F6 This option allows you to rename the highlighted file. You must at least provide a filename and extension. Toggle the Tag status - SPACE Pressing the space bar will toggle the tagged status of the currently highlighted file. A check mark to the left of the filename indicates that it is tagged. As files are tagged and untagged a count of the number of files tagged along with the total size of all tagged files is updated on the main screen. SHEZ USER MANUAL Page -20- Tag All Files - CTL-SPACE or CTL-T This option will tag all files Untag all Files - CTL-U This option will untag all tagged files. Add/Update compressed file comments - ALT-C This option allows you to add/update the file comment records in all tagged compressed files. To use this option first create an ASCII file that contains the file comments you wish to add to the compressed files. Then tag the files you wish to update, and press the ALT-C keys. You will be prompted for the ASCII file that contains your comment record(s). SHEZ will then execute the appropriate compressed file maintenance program to add/update the file comments in each tagged compressed file. Immediate Exit ALT-Q This option will immediately exit SHEZ. Test tagged compressed file(s) for viruses - ALT-Z Using this option SHEZ interfaces with the virus scan program (SCAN.EXE) that is produced by McAfee Associates. You must have version 39 or greater of this scan program in order for SHEZ to use it correctly. First tag all the compressed files in the directory window that you wish to test. Then press the ALT-Z keys, or use the drop down menus. SHEZ will extract all .COM, .EXE, and .OV? files into its working directory for each tagged compressed file, and will execute the virus scan program to determine if any of the program files have been infected. If an infected program is found SHEZ will temporarily suspend its processing allowing you to see which programs are infected. You may then press any key to continue scanning the rest of the tagged files. (See the configuration section of this manual for more information on configuring SHEZ for this option). If there are any nested compressed files, SHEZ will also search the nested compressed files for .COM, .EXE, and .OV? files for viruses. The nesting level search is limited only by the amount of free disk space in the work drive assigned to SHEZ. Test for viruses and strip comments out of .ZIP files - CTL-Z This option perform exactly the same function as the ALT-Z command, with the added feature of stripping the master comment record out of any .ZIP files that are scanned. SHEZ USER MANUAL Page -21- Copy all TAGGED DOS files - SFT-F2 Move all TAGGED DOS files - SFT-F3 Delete all TAGGED DOS files - SFT-F4 Rename all TAGGED DOS files - SFT-F6 These options allow you to copy,move,delete, and rename the DOS files that are tagged in the file window. Please note will be asked if you want to delete the files. Respond Y if you wish to delete the files, anything else will abort the delete. The deleted,moved and renamed files name will not be removed from the displayed list. Instead it will be flagged with an # to the left of the filename and a 'd', 'm', or 'r' to the right. When copying or moving files the new files will retain the original file's time and date stamp. Alternate file viewers - CTL-ENTER Pressing the CTL-ENTER command will allow you to view the currently highlighted file using a user specified alternate file viewer. (SEE THE SECTION "SETTING UP ALTERNATE FILE VIEWERS" ON PAGE 51 FOR MORE INFO) Toggle authenticity mode in PKZIP - ALT-1 Pressing the ALT-1 keys will toggle the authenticity mode when using PKZIP. If the authenticity mode is active an ! will appear on the file list heading line to the right of [FILE LIST] box. When processing files in the authenticity mode SHEZ will instruct SHEZ to EXCLUDE a file named AVEXTRA.TXT. This will allow you to add additional comments to a authenticated ZIP file without actually adding the file that contains the comments to the ZIP file. Edit highlighted file - ALT-E Pressing the ALT-E key tells SHEZ to invoke the user defined editor on the highlighted file. Tag highlighted file - (Plus key +) Pressing the + key will tag the highlighted file and move the highlight bar down one line. Untag highlighted file - (Minus key -) Pressing the - key will untag the highlighted file and move the highlight bar down one line. Tag highlighted file - ALT-+ Pressing the + key will tag the highlighted file and move the highlight bar up one line. Untag highlighted file - ALT-- Pressing the - key will untag the highlighted file and move the highlight bar up one line. Exit SHEZ goto EXTRACT dir - CTL-X Pressing the CTL-X key will immediately exit SHEZ and will place you into the EXTRACT disk and directory. Macro Pause - ALT-5 SHEZ USER MANUAL Page -22- Start/Stop recording keystrokes - ALT-6 Playback recorded keystrokes - ALT-7 Cancel recording/playbak - CTL-Q Save recorded keystrokes - ALT-9 Load and Execute keystroke file - ALT-8 See the section entitled KEYSTROKE RECORDING/PLAYBACK FACILITY on page 43 for a full explanation of the keystroke record/playback facility. Activate volume label processing - ALT-4 Pressing the ALT-4 key will activate the automatic volume label processing option in SHEZ. See section titled VOLUME LABEL SUPPORT on page 41 further information. Browse any file - ALT-B Pressing the ALT-B keys will allow you to view the contents of a user specified file. A window will open asking you to enter the file specification of the file you wish to view. Pressing the Enter key will invoke the file browsing program. Pressing the ESC key will cancel the request. Wild card Toggle - F6 Pressing the F6 key will toggle the wild card specification between *.* and $.$. If SHEZ was started with a wild card specification other than *.* or $.$ this command has not effect. 4DOS/NDOS file description display - ALT-D If you are running under 4DOS or NDOS and there is a DESCRIP.ION file in the directory you are looking at, pressing the ALT-D keys will display the 4DOS/NDOS description file contents to the right of the filenames, (First 23 characters only), and in a dialog box in the lower right corner of the screen. The dialog box will only appear when the DOS directory window is NOT zoomed full screen. Pressing the ALT-D again will display the file time, date, and size. (PLEASE NOTE: SHEZ CAN ONLY HANDLE DESCRIP.ION FILES THAT ARE 30,000 BYES OR LESS) HOT DIRECTORY display - TAB KEY Pressing the TAB key will open a second DOS directory display window. Before the window is opened SHEZ will prompt you for the DISK and Directory to display. (Be sure to include the trailing backslash. I.E. C:\MINE\) If no file specification is included, a *.* file specification will be used. When the directory window is open you may perform all supported file operations, such as copying, deleting, moving, single and/or groups of tagged files. You can close the directory window by pressing the TAB KEY again, or exit SHEZ by pressing the ALT-Q keys or the CTL-X keys. Delete highlighted / tagged file(s) - DEL KEY Pressing the delete key, will delete the highlighted file, if no files are currently tagged. If there are files tagged then all tagged files will be deleted. Run PKZIPFIX against highlighted file - ALT-F Pressing the ALT-F key will run the PKZIPFIX program against the currently highlighted file. It will create a PKFIXED.ZIP file in the same directory that the highlighted file exists in. SHEZ USER MANUAL Page -23- Format Floppy - ALT-O The ALT-O hot key sequence will allow you to format a floppy disk in the A: or B: drives. See the section titled FORMATTING FLOPPIES later in this document. Update/Add 4DOS/NDOS file description - ALT-U If you are running under 4DOS or NDOS pressing the ALT-U key will allow you to Update and/or Add a file description line to the currently highlighted file. If a DESCIPT.ION file does not exist one will be created, if it does exist it will be updated. Execute highlighted program - F5 Pressing the F5 key, will execute the currently highlighted file if the file is a .EXE or .COM file. Modify file attributes - ALT-A Pressing the ALT-A keys will allow you to modify the highlighted file's attributes. First an information box will appear showing you the files current attributes. To modify the file's attributes press the ENTER key and a selection menu will appear. Using the space bar, tag the new attributes you wish to set and/or reset and press the ENTER key to perform the modification. Right and Left cursor keys The Right and Left cursor keys will now scroll the directory display windows RIGHT and LEFT allowing you to see the files attributes or the remainder of the 4DOS description text. QUICKVIEW a file - CTL-Q The CTL-Q command will activate SHEZ'S QUICKVIEW feature allowing you to view the currently selected file. Strip Comments from ZIP files - CTL-S The CTL-S command will remove the master comment records from ZIP comressed files. This command will perform it's function on all tagged files, or only the currently hightlighted file if no files are tagged. Strip Comments from ZIP files - CTL-S The CTL-S command will remove the master comment records from ZIP comressed files. This command will perform it's function on all tagged files, or only the currently hightlighted file if no files are tagged. Create Directory - CTL-F4 Pressing the CTL-F4 keys will pop-up a dialog box allowing you to enter the name of the directory you wish to create. This feature allows you to create an entire directory tree in one pass. I.E. When the dialog box appears you can enter the following: D:\ONE\TWO\THREE\FOUR Of course you can still specify a single directory name when the dialog box appears. Delete Directory Tree - CTL-F5 USE THIS COMMAND WITH CAUTION!!!!!!!!!!!!!!!!!!!!! The CTL-F5 command will delete the hightlighted directory and ALL FILES AND DIRECTORIES UNDER IT. This is a fast way to remove a directory, but please use it with extreme caution. Print Functions - CTL-P SHEZ USER MANUAL Page -24- This command will bring up a print function menu. When a printer is selected SHEZ will print either the TAGGED files, or only the currently highlighted file depending on the response to a dislog prompt. The following menu items will always appear: Change printer port This option allows you to direct the print to an LPT port or to a file. To direct to an LPT port enter LPT1-9 when prompted for location to print. DOS printer 80col This will print the tagged or currently highlighted file in a generic 80 column print mode. DOS printer 132col This will print the tagged or currently highlighted file in a generic 132 colume print mode. DOS printer HEX print This will print the tagged or currently highlighted file in hex mode. HPLASER II-IV 2up print This will print the tagged or currently highlighted file in landscape mode, two logical pages per physical page. NOTE: Thie print function will only operate on LASER printers that support the HP LASER PCL 4 printer control codes. IT WILL NOT OPERATE CORRECTLY ON A HPLASER IIP. HPLASER II-IV land/bar This will print the tagged or highlighted files in compressed landscape mode shading every other line. Up to 166 characters can appear on each print line. In addition to this menu items, if the user has defined additional printer in the SHEZ.INI file their names will appear after the HPLASER 2up print menu item. Virus scan directory - ALT-S This command will scan the currently highlighted directory for viruses using the user defined virus scanning software. Zoom / Unzoom window - ALT-M When the DOS directory window is displayed, pressing the ALT-M keys will ZOOM or UNZOOM the window to full screen width. When operating under 4DOS, if the user has 4DOS description display enabled, the 4DOS file descriptions will appear in the ZOOMED window to the right of the filenames. View FILE_ID.DIZ - ALT-F1 Pressing the CTRL-D keys will cause SHEZ to search the highlighted compressed file, or all tagged files,for either of two files, FILE_ID.DIZ and DESC.SDI. If either of these two files are found SHEZ will display the contents of the found file in a pop-up window on the right side of the screen. After the popup screen is displayed pressing the ENTER key will remove the popup screen and will position the highlight bar one item down in the DOS directory list. Pressing the CTRL-ENTER key will remove the popup screen and will display the contents of the compressed file in the compressed file screen display. If the FILE_ID.DIZ file does not exist the user will be asked if they wish to create one. If they respond Y the users defined editor will be activated allowing the user to create a FILE_ID.DIZ file. After SHEZ USER MANUAL Page -25- the user saves the newly created file it will be saved back into the compressed file. Change sort order - ALT-F9 Pressing the ALT-F9 allows you to change the sort order of the displayed file list. You may change the sort order to Ascending or Descending by pressing the A or D key in the dialog box. Smart copy - ALT-F2 Pressing the ALT-F2 keys will activate the smart copy function. The smart copy function performs the same function as the COPY TAGGED function with the additional feature of optimially filling the target drive. SHEZ will scan the tagged file list and will select combinations of files to maximally fill the target drive. If all files will not fit on the target drive, SHEZ will untag the files that it could copy leaving the files that could not be copied tagged. SHEZ USER MANUAL Page -26- UUENCODE - ALT-F8 Pressing the ALT-F8 keys will UUENCODE the tagged or highlighted file(s). If no files are tagged then only the highlighted file will be UUENCODED. Before UUENCODING the file(s) a dialog box will appear prompting you for the disk and directory of where to place the UUENCODED files. The ENCODED files will have the same filenames as the orginial file(s) with a file extension of .UUE. UUDECODE - CTL-F8 Pressing the CTL-F8 keys will UUDECODE the tagged or highlighted file(s). If no files are tagged then only the highlighted file will be DECODED. Before DECODING takes place a dialog box will appear prompting you for the disk and directory of where to place the DECODED files. The DECODED files that are created will have the same name as when they were orginially encoded. DISK-FREE-SPACE - CTL-F Pressing the CTL-F keys will display a dialog box in the upper right corner of the screen which will show the amount of free space on the current default drive. The cursor will be positioned on the drive letter and the user can enter a new drive letter, press the ENTER key and obtain free space information on any attached drive. Pressing the ESC key will remove the dialog box. Smart move - ALT-F3 Pressing the ALT-F3 keys will activate the smart move function. The smart move function performs the same function as the MOVE TAGGED function with the additional feature of optimially filling the target drive. SHEZ will scan the tagged file list and will select combinations of files to maximally fill the target drive. If all files will not fit on the target drive, SHEZ will untag the files that it could move leaving the files that could not be moved tagged. Extract all - ALT-X The ALT-X keys will extract all files from the highlighted or all tagged files. If files are tagged the user will be asked if they want to perform the function on the highlighted file or on the tagged files. The user will also be prompted at the beginning of the operation for the extract location. During this extraction operation the Overwrite and restore directory options are always in effect. Update 4DOS Desc. CTL-F1 The CTL-F1 function will update the 4DOS desciption file using the FILE_ID.DIZ or DESC.SDI file that is contained within the compressed file. This function will operate on the currently highlighted file or all tagged files. If files are tagged a dialog box will ask if you wish to process against the highlighted file or the tagged files. Update FILE_ID.DIZ - ALT-F4 The ALT-F4 functions operates the reverse of the CTRL-F1 function. This functions will add and/or update the FILE_ID.DIZ file contained within the compressed file using the information in the 4DOS description file. If a FILE_ID.DIZ file does not exist one will be added to the compressed file. If it does exist SHEZ USER MANUAL Page -27- it will be updated. This function will operate on the currently highlighted file or all tagged files. If files are tagged a dialog box will ask if you wish to process against the highlighted file or the tagged files. SHEZ USER MANUAL Page -28- FUNCTIONS WHEN VIEWING CONTENTS OF ARCHIVE FILE: Viewing a file - V Simply press the return key or the V key. This will temporarily unpack the file and will invoke the LIST program allowing you to view the file on your screen. The temporary copy of the extracted file will be placed in the current disk and directory unless you specified a work disk to be used by using the configuration program. SHEZ will allow you to operate on compressed files that are contained within compressed files. I.E. A zip file that contains zip files. To view the contents of the embedded compressed file simply move the highlight bar to the compressed file and press the ENTER key. The embedded compress file contents will now be displayed on the screen. You may view any of the files and/or extract any of the files contained in the compressed file. However you may not add, delete, or update the embedded compressed file. Extracting a single file - E. This will extract the file that is being pointed to. The extracted file will be placed on the current disk in the current directory. You may optionally use the ALT-P command to direct the extracted files to a different disk and/or directory. Testing archive integrity - T This will test the integrity of the archive file and will report the results on the screen. Display Info about archive file - I This will display information about the archive file in a small pop-up window at the top of the screen. The information will include the number of files in the archive, the date of the newest file in the archive, the total size of all the files in the archive including the total expanded size and total compressed size. It will also display the current default compression factor. Delete a file from the archive - D This will delete the selected file from the archive file. Before the file is deleted a prompt will appear asking for verification of the delete. In addition any files that were previously tagged will have the tag cleared. Delete a tagged files from an archive - CTL-D This command will deleted all tagged files from the archive file. Before the files are deleted a prompt will appear asking for verification of the delete operation. SHEZ USER MANUAL Page -29- Add file(s) to archive - A Update files(s) in archive - U Move files(s) to archive - M Freshen file(s) in archive - F Each of these options will cause a small window to open at the bottom of the screen. The window will prompt you to enter one or more file specifications. These filespecs can include drive, path, and a filespec with wild cards. All files matching the indicated filespec will be added, updated, moved or freshened in the current archive file depending on which option you initially picked. Any files that were previously tagged will have the tag cleared. For example if you enter a U to update files in the archive and you enter c:\source\*.c d:\batch\*.c when prompted to enter a filespec, than all files on the C drive in the source directory that have a file extension of C, and all files on the D drive in the batch directory that have an extension of bat, will be updated in the current archive file. List of files to add to archive - ALT-A List of files to freshen in archive - ALT-F List of files to move to archive - ALT-M List of files to update in archive - ALT-U Again each of these options will cause a small window to open at the bottom of the screen. The window will prompt you to enter a filespec. This filespec can include drive, path, and a filespec with wild cards. When you press the return key another window will pop-up on the left side of the screen showing you all the files that were found that matched the filespec you entered. You can then use the cursor keys to scroll the file list. Pressing the space bar will toggle the tagged status of the current highlighted file. When you are done tagging file press the return key and all files that you tagged will be added, freshened, moved, or updated in the current archive file. END GROUP Specify where to put extracted files - ALT-P This options will prompt you to enter a drive and directory of where to place files that you extract from the archive. This location will remain in effect until you enter the ALT-P command again and clear the drive and directory or you change to another archive file. This command is used when you want to place extracted files in a location other than the current drive and directory. If you specify a directory that does not exist a ERROR/INFORMATION window will appear indicating that the directory does not exist. You may press the F10 key to create the directory. This command may be issued at any time. When the input window appears pressing the F9 key will open another window which will display a scrollable list of directories. To display a list of directories other than on the current drive, enter the drive letter followed by a colon, then press the F9 key. Scroll the list using the up and down cursor keys, and press the ENTER key to select the directory you wish to extract files into. SHEZ USER MANUAL Page -30- Extract all files from archive - ALT-X This command will extract all files from the archive file and place them in the current disk:\directory unless you specified a different extract location by using the ALT-P command. Delete all extracted files - ALT-D This command will delete all files in the current disk:\directory, or the one specified by the ALT-P command, that are also contained in the archive file. The files will only be deleted if the file time and date are equal to or less then the file time and date of the same file that is contained in the compressed file. NOTE: it does not delete anything from the archive file. This is useful when you extract file from the archive file and then you want to quickly delete all the extracted files. Execute a file in an archive file - R This command will execute the EXE or COM file that is currently highlighted on the archive file list. The EXE or COM file will be extracted from the archive file and will be placed on the current disk in the current directory. You will then be prompted to enter any optional command line parameters that the program is expecting. The selected program will then be executed. After the program is run the extracted file will be deleted. NOTE: You can specify a different disk drive to place the extracted file on by using the SHEZFG program. This is useful when working with archive files that are on floppy disks. If you specify disk C as the work disk in the SHEZFG program the extracted file will be placed on the C drive, will be executed from the C drive, and then will be deleted from the C drive. Speed search - ALT-S This option will allow you to quickly find a file in an archive. A window will pop-up asking you to enter a match pattern. This pattern follows the standard DOS wildcard specifications. The list of files on the screen will then be scrolled to the first file that matches the pattern. Pressing ALT-S again and pressing the ENTER key will position the highlight bar to the next file that matches the pattern. Immediate Exit - ALT-Q This option will immediately exit SHEZ. Extract all tagged files - CTL-E This option will extract all files that you tagged in the archive file. To tag a file simply press the space bar to toggle the tagged status. When a file is tagged it will be highlighted on the screen. Toggle the Tag status - SPACE Pressing the space bar will toggle the tagged status of the currently highlighted file. A check mark to the left of the filename indicates that it is tagged. Untag all tagged files - CTL-U This option will untag all files that you previously tagged. Tag All Files - CTL-SPACE This option will tag all files SHEZ USER MANUAL Page -31- Update the archive files time and date - CTL-T This option will change the archive file's time and date to match the time and date of the newest file in the archive file. Create a new archive file - F7 This option allows you to create a new compressed file. For further information see the section titled, CREATING NEW COMPRESSED FILES on page 46. Show help screen - F1 This will display a help screen showing all currently supported commands. Any command can be entered while the help screen is displayed. Temporary exit to DOS - F10 This will temporarily clear the screen and exit to DOS. You can then execute and command you want. To return to SHEZ type in EXIT at the DOS prompt and press return. (Not available when running under DESQVIEW) Temporary exit to DOS into Extract Directory - ALT-F10 This will temporarily clear the screen and exit to DOS into the currently defined extract directory. You can then execute and command you want. To return to SHEZ type in EXIT at the DOS prompt and press return. (Not available when running under DESQVIEW) Select a new archive file - F2 This option will prompt you to enter a new disk, directory, and filespec to find another archive file to work with. If you enter a filespec of $.$ SHEZ will only list directory entries and file that have extensions of .ARC, .ZIP, .LZH, .PAK, ARJ, ZOO, SQZ. RAR, and UC2. Sort the archive file list - F9 This option will allow you to sort the archive file list by Name, Extension, Date, Size, or Path name. A small window will open up asking you how you want the list sorted. Enter a N, E, D, S, or P. When sorting by Path name the files will be soted by name within pathname. A dialog box will also appear asking if you want to sort in Ascending or Descending order. Edit the selected file - F8 This option will extract the selected file onto either the default disk or the work disk specified via the configuration program. It will then invoke the editor specified via the configuration program passing the selected filename.ext to the editor. When you exit your editor SHEZ will then MOVE the extracted file back into the archive, if it has been modified, and delete the extracted copy. If an editor was not specified during the configuration process this command will not function. If the compressed file is a .ZIP file and authenticity mode in toggled on when the edited file is saved back into the compressed file the authenticity mode will be honored. If the file being edited has directory information stored with the filename, SHEZ will retain the directory information even when saving the file back into the compressed file. SHEZ USER MANUAL Page -32- Specify an archive file mask - Z This option allows you to display only the files in the archive that match the file mask. The file mask uses the same wild card conventions as DOS. Toggle overwrite mode - O This option toggle overwrite mode on and off. When overwrite mode is in effect an 'O' will appear in the upper right hand corner of the screen. When overwrite mode is in effect, and you extract a file from an archive, it will be extracted even if it already exists on the target disk:\path. Add Update File Comments - ALT-C This option allows you to add and/or update the compressed file comments. Supply Password for File - G This option allows you to supply a password when working with password encrypted files. The password will be used when extracting, viewing, and modifying the currently selected compressed file. When a password has been supplied the compressed file display window will indicate that a password is in effect. Set Path/Directory option - P If a file has been saved into a compressed file with a directory name the name will appear on the right side of the compressed file list. Normally when you update or extract files from a compressed file the directory information is ignored. Using the 'P' option you can tell SHEZ that you want to save and/or use the directory information. When you press the 'P' key a list of three options will appear on the screen. The first option "Do not use Dir info", tells SHEZ to ignore directory information. The second option "Use Dir Info" tells SHEZ to save the directory information when updating a compressed file, or to use the directory information when extracting files. The third option, "Use Dir Info and Recurse", tells SHEZ to save directory information when updating a compressed file and to recurse down the directory tree when looking for files. The third option also tells SHEZ to use the directory information when extracting files. The selected option will remain in effect until you specifically reset it using the P command again. The following options are passed to the compression programs when directory information is to be used: USE DIR INFO USE DIR INFO AND RECURSE Pkzip -P Pkzip -Pr Pkunzip -d Pkunzip -d Lharc /x Lharc /x /r Lharc /x (when extracting) Lharc /x (when extracting) Please consult the compression program's documentation for further information on what these options do. SHEZ USER MANUAL Page -33- View file and archive comment records - ALT-V This option will display on the screen the contents of the archive file along with any comment records that have been placed into the archive file. Add/Update highlighted archive file comments - s This option will allow you to add and/or update comment records that are associated with the highlighted file in the archive. Add/Update all archive file comments - SHIFT-S This option will allow you to add and/or update comment records that are associated with the each file in the archive. Convert SFX file - CTL-V This option will convert a self extracting compressed file (.COM or .EXE) back to a normal compressed file. The normal compressed file will be placed on the same disk and in the same directory when the self extracting is located. The self extracting file will remain intact. Please note that this option is only available when you are viewing the contents of a self extracting file. For a list of the self extracting file that can be read my SHEZ see the section titled SELF EXTRACTING FILE SUPPORT on page 48. Test COM,EXE, and OVL files in a compressed file for viruses -ALT-Z Using this option SHEZ interfaces with the virus scan program (SCAN.EXE) that is produced by McAfee Associates. You must have version 39 or greater of this scan program in order for SHEZ to use it. When you press the ALT-Z key SHEZ will extract all .COM, .EXE, and .OV? files into its working directory and will execute the virus scan program to determine if any of the program files have been infected. (See the configuration section of this manual for more information on configuring SHEZ for this option). Beginning with release 6.5 of SHEZ you may now tag the files you wish to check for viruses before pressing the ALT-Z keys. When files are tagged, only the tagged files will be checked. Extract only newer files - ALT-N The ALT-N command will only extract files contained in the compressed file that are newer than the files that are contained in the extract directory. If no files are TAGGED ALT-N will extract all newer files that are contained in the compressed file into the extract directory. If there are files tagged, only the newer tagged files will be extracted. Alternate file viewers - CTL-ENTER Pressing the CTL-ENTER command will allow you to view the currently highlighted file using a user specified alternate file viewer. (SEE THE SECTION "SETTING UP ALTERNATE FILE VIEWERS" on page 51 FOR MORE INFO) SHEZ USER MANUAL Page -34- Show tagged file count - ALT-T Pressing the ALT-T keys will toggle the function key line to show you, the number of files tagged, total compressed file size, and total uncompressed file size. If the compressed files you are working with is a ZIP file it will also show you the size of the ZIP file that will be created if you build a new ZIP files containing all of the tagged files. Please note this is only an estimate and does not take into account file comment records and it assumes that the compression method will be the same as is currently used. Toggle authenticity mode in PKZIP - ALT-1 Pressing the ALT-1 keys will toggle the authenticity mode when using PKZIP. If the authenticity mode is active an ! will appear on the heading line to the right of the NAME heading field. Copy tagged members to another compressed file - CTL-Y The CTL-Y command allows you to copy selected members of a compressed file to another compressed file. The target compressed file can be any currently supported compressed file format. To perform the copy, first open up the compressed file you wish to copy FROM. Then using the space bar tag the files you wish to copy. Next press the CTL-Y keys. A window will appear asking you to enter the FULL path of the compressed file to want to copy the selected members into. You may enter only a DRIVE:\PATH\ (note ending backslash) and press the F9 key to obtain a listing of file in the entered directory, or you may enter the complete filespec of the target compressed file. You may also press the F9 key as soon as the window appear to obtain a list of files in the current directory. Pressing the enter will then perform the copy operation. The files that were tagged will remain tagged after the copy operation has been performed allowing you to do a CTL-D (delete all tagged files) if desired. If the file you wish to copy to does not exist a window will appear asking if you want to create a new compressed file. Press the F10 key to created a new file, Press any other key to re- enter the name of the compressed file to copy to. Tag highlighted file - (Plus key +) Pressing the + key will tag the highlighted file and move the highlight bar down one line. Untag highlighted file - (Minus key -) Pressing the - key will untag the highlighted file and move the highlight bar down one line. Exit SHEZ - ESC Exit SHEZ goto EXTRACT dir - CTL-X Pressing the CTL-X key will immediately exit SHEZ and will place you into the EXTRACT disk and directory. Right and Left cursor keys The RIGHT and LEFT cursor keys will scroll the compressed file view window RIGHT and LEFT allowing you to view long path names if they are stored in the compressed file. SHEZ USER MANUAL Page -35- Macro Pause - ALT-5 Start/Stop recording keystrokes - ALT-6 Playback recorded keystrokes - ALT-7 Cancel recording/playbak - CTL-Q Save recorded keystrokes - ALT-9 Load and Execute keystroke file - ALT-8 See the section entitled KEYSTROKE RECORDING/PLAYBACK FACILITY on page 43 for a full explanation of the keystroke record/playback facility. Activate volume label processing - ALT-4 Pressing the ALT-4 key will activate the automatic volume label processing option in SHEZ. See section titled VOLUME LABEL SUPPORT on page 41 for further information. Add volume label to existing compressed file - $ Pressing the $ key will allow you to add volume label information to an existing ZIP or ARJ compressed file. See section titled VOLUME LABEL SUPPORT on page 41 for further information. Browse any file - ALT-B Pressing the ALT-B keys will allow you to view the contents of a user specified file. A window will open asking you to enter the file specification of the file you wish to view. Pressing the Enter key will invoke the file browsing program. Pressing the ESC key will cancel the request. Scan file(s) for a string - ALT-G This command will allow you to search all, or only tagged files, for a specific string using the supplied SGREP program. After the search is performed, the result of the search will be displayed on the screen. When doing a search on numerous files or on a long file the search can be canceled by pressing the ESC key. For more information on the supplied SGREP program see the section titled, THE SGREP PROGRAM, later in this document. Run a program against all tagged files - ALT-Y This command will execute a user specified program against all tagged files. The user will be prompted for the program to run, and the command line options to pass to the program. The command line options MUST AT LEAST INCLUDE the special file name variable $F to tell SHEZ where to place the filename in the command line to pass to the specified program. The user can also indicate if SHEZ should pause after each execution to allow the user view the output of the program. HOT DIRECTORY display - TAB KEY Pressing the TAB key will open a second DOS directory display window. Before the window is opened SHEZ will prompt you for the DISK and Directory to display. (Be sure to include the trailing backslash. I.E. C:\MINE\) If no file specification is included, a *.* file specification will be used. When the directory window is open you may perform all supported file operations, such as copying, deleting, moving, single and/or groups of tagged files. SHEZ USER MANUAL Page -36- You can close the directory window by pressing the TAB KEY again, or exit SHEZ by pressing the ALT-Q keys or the CTL-X keys. Delete highlighted / tagged file(s) - DEL KEY Pressing the delete key, will delete the highlighted file, if no files are currently tagged. If there are files tagged then all tagged files will be deleted. Format Floppy - ALT-O The ALT-O hot key sequence will allow you to format a floppy disk in the A: or B: drives. See the section titled FORMATTING FLOPPIES later in this document. Rename highlighted file - ALT-R The ALT-R command will allow you to rename a file contained in a compressed file. This is accomplished by 1) extracting the highlighted file, 2) renaming the extracted file, 3) adding the renamed file back into the compressed file, and 4) deleteing the orginial highlighted file from the compressed file. QUICKVIEW a file - CTL-Q The CTL-Q command will activate SHEZ'S QUICKVIEW feature allowing you to view the currently selected file. Strip Comments from ZIP files - CTL-S The CTL-S command will remove the master comment records from ZIP comressed files. SHEZ USER MANUAL Page -37- Print Functions - CTL-P This command will bring up a print function menu. The following menu items will always appear: Change printer port This option allows you to direct the print to an LPT port or to a file. To direct to an LPT port enter LPT1-9 when prompted for location to print. DOS printer 80col This will print the currently highlighted file in a generic 80 column print mode. DOS printer 132col This will print the currently highlighted file in a generic 132 colume print mode. DOS printer HEX print This will print the currently highlighted file in hex mode. HPLASER II-IV 2up print This will print the currently highlighted file in landscape mode, two logical pages per physical page. NOTE: Thie print function will only operate on LASER printers that support the HP LASER PCL 4 printer control codes. IT WILL NOT OPERATE CORRECTLY ON A HPLASER IIP. In addition to this menu items, if the user has defined additional printer in the SHEZ.INI file their names will appear after the HPLASER 2up print menu item. Change sort order - ALT-F9 Pressing the ALT-F9 allows you to change the sort order of the displayed file list. You may change the sort order to Ascending or Descending by pressing the A or D key in the dialog box. UUENCODE - ALT-F8 Pressing the ALT-F8 keys will UUENCODE the tagged or highlighted file(s). If no files are tagged then only the highlighted file will be UUENCODED. Before UUENCODING the file(s) a dialog box will appear prompting you for the disk and directory of where to place the UUENCODED files. The ENCODED files will have the same filenames as the orginial file(s) with a file extension of .UUE. UUDECODE - CTL-F8 Pressing the CTL-F8 keys will UUDECODE the tagged or highlighted file(s). If no files are tagged then only the highlighted file will be DECODED. Before DECODING takes place a dialog box will appear prompting you for the disk and directory of where to place the DECODED files. The DECODED files that are created will have the same name as when they were orginially encoded. DISK-FREE-SPACE - CTL-F Pressing the CTL-F keys will display a dialog box in the upper right corner of the screen which will show the amount of free space on the current default drive. The cursor will be positioned on the drive letter and the user can enter a new drive letter, press the ENTER key and obtain free space information on any attached drive. Pressing the ESC key will remove the dialog box. Optimize a UC2 compressed file - ALT-I SHEZ USER MANUAL Page -38- UltraCompressor II has the ability to optimize its compressed file. This is especially usefull if many additions or changes have been made to the compressed file. It can also be usefull to squeeze a little extra compression out of newly created UC2 compressed files. SHEZ USER MANUAL Page -39- OPTIONS AVAILABLE ONLY VIA THE MENU SYSTEM There are a few options that are only available via the built-in menu system. To activate the menu system press the forward slash key, /, and a menu bar will appear on the top line of the display. When the DOS directory screen is displayed, the following commands are only accessible via the menu system. To access these commands press the / key, and move to the Opts menu item using the RIGHT CURSOR key, then press the ENTER key. A list of selectable items will appear. Set ZIP Compression Method Selecting this option will cause a window to appear listing the available compression method options. Using the UP/DOWN cursor keys highlight the compression method you wish to use, and press the space bar to select. A check mark will appear to the left of the selected method. This method will remain in effect until you change it again, or exit SHEZ. After making your selection, press the ENTER key to activate your selection. Set ARJ Compression Method This option is the same as described above except it sets the compression method for ARJ type files. Set UC2 Compression Method This option is the same as described above except it sets the compression method for UC2 type files. Virus scan ALL files Selecting this option will instruct SHEZ to test all files contained in compressed files for Viruses. This will remain in effect until you reset the option, or exit SHEZ. Virus scan ONLY EXECUTABLE files. Selecting this option will instruct SHEZ to test only executable files contained in compressed files for Viruses. Set Paging option for DOS and EDIT Selecting this option allows you to activate or de-activate the paging option when shelling to DOS, running an external program, or running an external Editor. Set Paging option for External Viewers Selecting this option allow you to activate or de-activate the paging option when running an external viewer program. When the compressed file contents screen is displayed, the same set of commands are only accessible via the menu system. To access these commands press the / key, and move to the Other menu item using the RIGHT CURSOR key, then press the ENTER key. A list of selectable items will appear, the items listed above will be included in this list. There is another set of option that is accessible only via the menu system when the compressed file contents screen is displayed. This option all appear under the main PRINT menu option. PRINT DIRECTORY OF COMPRESSED FILES SHEZ USER MANUAL Page -40- Selecting the "Print directory of compressed file" allows you to print a formatted listing of the contents of the compressed file. If this item is selected a drop down dialog box will appear allowing you to print to LPT1, LPT2, or LPT3. Also under the CONVERT menu option the following menu item will appear: CONVERT TO ANOTHER FORMAT This option allows you to convert the compressed file you are currently viewing to a different type of compressed file. Macro Help This selection instructs you to press the F1 key to obtain help on the macro recording/playback hot keys. Set macro playback speed Selecting this option will cause a selection box to appear allowing you to change the macro playback speed. The available options are SLOW, MEDIUM, and FAST. The default value is FAST. SHEZ USER MANUAL Page -41- VOLUME LABEL SUPPORT Shez now supports adding and extracting volume label information to/form compressed files. Volume label processing is only supported for ZIP and ARJ type compressed files. ADDING VOLUME LABELS WHEN CREATING NEW COMPRESSED FILES: When creating a new ZIP or ARJ file via the F7 key, you will be asked if you wish to store volume label information. If you respond Y, you will then be asked to enter the Drive Letter of the drive to obtain the volume label information from. Enter the drive letter (A-Z). Please note: these prompts will only appear if you are creating a ZIP or ARJ compressed file. ADDING VOLUME LABELS TO AN EXISTING ZIP OR ARJ FILE: To add volume label information to a pre-existing ZIP or ARJ file, first open the compressed file by moving the highlight bar to the appropriate file. Then press the enter key. This will open the compressed file. Then press the $ key (SHIFT 4). You will be asked to enter the drive letter to obtain the volume label information from. Enter the drive letter (A-Z). The volume label from the specified drive, if any exists, will be added to the compressed file. EXTRACTING VOLUME LABEL INFORMATION: To extract volume label information from an existing compressed file, press the ALT-4 key to turn on automatic volume label processing. When automatic volume label processing is active a $ will appear next to the NAME field heading in the compressed file listing, or will appear in the upper left corner of the DOS directory display window. After activating automatic label processing, open the appropriate compressed file as documented above. Set the extract location using the ALT-P (extract path) command. Then extract any or all files from the compressed file. During the extraction process the volume label contained in the compressed file will be used to update the volume label information on the extract drive. PLEASE NOTE: ONCE YOU TURN AUTOMATIC VOLUME LABEL PROCESSING ON, IT WILL REMAIN ON UNTIL YOU TURN IT OFF BY USING THE ALT-4 KEY AGAIN. PLEASE USE THIS OPTION WITH CARE. FLOATING EXTRACT LOCATION SHEZ now supports a concept called the floating extract location. The feature was added due to numerous user requests, and is an option feature which is activated via the SHEZCFG program. Normally when SHEZ is executed SHEZ sets the file extract location to the current disk and directory. When you change to a different disk and/or directory the extract location remains constant, pointing to the disk and directory where SHEZ was started from. To change the extract location you needed to use the ALT-P command (change extract location). The floating extract location basically allows the extract location to float as you change to a new disk and/or directory. The extract SHEZ USER MANUAL Page -42- location will float to what ever disk and directory you are currently looking at. You can still dynamically specify an extract location by using the ALT-P command, but when the ALT-P command is issued the floating extract option will be de-activated from that point on. You can reactivate the floating extract location logic by pressing the ALT-P keys and entering a single asterick at the prompt. To activate the floating extract location option, use the SHEZCFG program and choose the ADDITIONAL SETUP INFORMATION menu item. When the SHEZCFG program prompt you for a default extract location, enter a single asterisk. The single asterisk tells SHEZ to activate its floating extract logic. Ultravision Support SHEZ is Ultravision "aware". SHEZ will operate in an Ultravision screen mode as long at the number of columns equals 80, and the number of rows are between 25-50. If SHEZ determines that Ultravision is installed, and it active in an non-supported screen mode, SHEZ will deactivate Ultravision, and then will set the screen mode to one of the supported modes. When SHEZ is exited, it will re-activate Ultravision and put the screen mode back into the Ultravision mode is was in before SHEZ was started. FORMATTING FLOPPIES SHEZ has the ability to format a floppy disk in either the A: or B: drives. The following disk capacities are supported: 5 1/4 drives: 360KB and 1.2OK, 3 1/2 drives: 720KB and 1.44KB. To format a disk press the ALT-O keys and a dialogue box will appear. Enter the drive letter you wish to format, the capacity to format, and if you wish each track verified during the format process. The verify process will increase the time it takes to format a disk. If you are using high quality disks you can opt to not verify to speed up the format process. After the disk is formatted you will have the option of adding a volume label to the disk. If no volume label is wanted simply press the ENTER key without entering any information. If your PC is an "XT" class machine, the format dialog box will ask you the type of disk drive you are formatting in. Enter the code that corresponds to the type of floppy drive you have installed. Formatting error codes can be found in the Apendix of this manual. SHEZ USER MANUAL Page -43- KEYSTROKE RECORDING/PLAYBACK FACILITY Shez now has the built in ability to record, playback, load, and save key stokes. All of the keystroke recording abilities must be activated from the keyboard. They can not be activated via the mouse or the pull-down menus. A menu item for MACROS do appear on the menu bar, but it is only used to access the help panel for keystroke recording. If you are using a mouse the functions performed by the mouse WILL NOT BE RECORDED. Only keystrokes entered directly from the keyboard will be recorded. During keystroke recording, the ALT-Q (QUIT SHEZ) key will be recorded, but will not be acted upon. This will allow the user to record and save the ALT-Q key into the playback macro. The keyboard HOT-KEYS and there functions are explained below: ALT-5 Macro record/playback PAUSE The ALT-5 key is used to PAUSE the record/playback macro function to allow the user to respond to a dialogue box prompt. When recording a macro and a dialogue box opens, press the ALT-5 key, then enter the response to the dialogue box. The macro recording will resume as soon as the user presses the ESC, ENTER, or Function keys. When playing back a macro that has been recorded using the PAUSE feature, the macro will PAUSE at the same location where the ALT- 5 key was originally pressed, allowing the user to enter data into a dialogue box prompt. For example: If you were recording a macro to search for a string of characters in a group of files and you wanted to input a different search string each time you executed the macro, you would: 1) Start the macro recording by pressing the ALT-6 key. 2) Open up the compressed file you wish to search. 3) Tag the files you what to scan through. 4) Press the ALT-G key to pop-up the search data entry box, as shown below: +-------------------------[D:\TC\ZIP\SHEZ65S.ZIP]--------------+ |NAME SIZE DATE TIME LENGTH METHOD PATH | |--------------------------------------------------------------| |DOSWDW ASM 2875 01/25/90 11:26 7677 IMPLOD | |MAKE286 BAT 80 06/25/91 14:25 100 SHRUNK | |MAKEALL BAT 80 10/03/91 10:25 89 SHRUNK | |MA+----[ENTER STRING TO SEARCH FOR:(NO DOUBLE QUOTES CHARS AL+| |MA|==> || |MA+-----------------[PRESS ENTER TO SAVE, ESC to cancel]-----+| |MAKESHEZ BAT 75 10/17/91 07:29 90 SHRUNK | |MSHEZD BAT 38 03/16/91 14:09 38 STORED | |SHEZ H 1466 11/22/91 07:39 4839 IMPLOD | +=Add B=Brows F=Fresh U=Update M=Move E=Xlist X=Xall P=Xpath QS+ 5) Press the ALT-5 key to PAUSE the macro facility. 6) Enter your search string and press the ENTER key. SHEZ USER MANUAL Page -44- 7) After the search is done press the ALT-6 key again to stop macro recording. 8) Press the ALT-9 key to save your macro. Now when you playback the macro, when the search data entry box appears the macro will pause allowing you to alter the search string before processing the rest of the recorded macro. When the macro facility is in PAUSE mode, the ESC key, ENTER key, or any FUNCTION key will resume the execution of the macro. ALT-6 Start/Stop recording keystrokes. Pressing the ALT-6 keys will toggle the keyboard recording mode. When SHEZ is recording keystrokes the speaker will blip after every keystroke is pressed. Pressing ALT-6 again will stop the keystrokes from being recorded. Up to 500 keystrokes may be recorded. ALT-7 Immediately play back the recorded keystrokes. Pressing the ALT-7 key will immediately playback your recorded keystrokes. CTL-Q Cancel recording/playback and flush the keystroke record buffer. Press the CTL-Q key either during a recording session, or during a playback, will cancel the record/playback, and will clear the keystroke buffer. ALT-9 Save recorded keystrokes. Pressing the ALT-9 key will pop-up a window allowing the user to save the recorded keystrokes into a file for use at a later time. You must stop recording by pressing the ALT-6 key before doing a save. This key will also reset the record/playback function and clear the keystroke buffer. ALT-8 Load and Execute a saved keystroke file. Pressing the ALT-8 key will pop-up a window allowing the user to enter the name of a previously saved keystroke file. After the file is loaded it will immediately be run. SHEZ will also allow the user to load and execute a save keystroke file at startup time. The command line parameter /play={filespec} tells SHEZ to load the indicated filespec and playback the recorded keystrokes. PLEASE NOTE: SHEZ DOES NOT VERIFY THAT THE CONTENTS OF THIS FILE ARE ACTUALLY RECORDED KEYSTROKES. SO BE CAREFUL WHEN SPECIFYING THE FILESPEC!! Examples: SHEZ D:\DOWN\*.ZIP /PLAY=D:\AUTOSHEZ.MAC Start SHEZ and display all the .ZIP files in the D:\DOWN directory, and load and execute the recorded keystrokes contained in the D:\AUTOSHEZ.MAC file. SHEZ USER MANUAL Page -45- SHEZ D:\SOURCE\CODE.ZIP /PLAY=D:\REFRESH.MAC Start SHEZ and open the CODE.ZIP file contained in the D:\SOURCE directory, and load and execute the recorded keystrokes contained in the D:\REFRESH.MAC file. The playback speed may also be sent to SLOW, MEDIUM, or FAST by using the mAcro drop down menu item and selecting the playback speed selection. The playback speed default is set to FAST. SHEZ USER MANUAL Page -46- CREATING NEW COMPRESSED FILES SHEZ allows you to create new compressed files either from the directory display window, using the F7 key, or from the compressed file display window using the "C" command. A window will appear asking you to enter the drive, directory, of where to place the new file. You may press the F9 key to view the directory structure in a tree format. After selecting the location of the new file another aditios will appear asking you to specify the name of the compressed file to be created. YOU MUST ENTER A FILE EXTENSION OF .ZIP,.ARC,.LZH,.ZOO,ARJ,SQZ,.PAK, RAR, or UC2 SO SHEZ KNOWS WHAT TYPE OF COMPRESSED FILE TO CREATE!!!!! Then you will asked if you want to add or move files into the new archive file. You will also be asked to enter an optional password. (If you enter a password all files added or moved to the archive file will be encrypted using the password. Do not forget the password you can not extract files from the file without the password and there is no way to determine the password if you forget it.) Please note the password prompt will only appear if the compression program used to create the new file support encryption. A window will then be opened that will ask you to enter the filespecs of the files you wish to add or move into the new archive file. This filespec can include a disk, directory, and file specifications with wild cards. A third window will be opened allowing you to specify processing options. The first option "Do you want to Tag files or Process as is" allows you to tell SHEZ that you want to Tag files for processing using the filespecs entered in the second window, or to simply pass the entered filespecs to the compression program exactly as entered. The second option "Do you want to save directory information" allows you to tell SHEZ that you want directory information saved in the compressed file. The third option "Do you want to recurse directories" will tell the compression program to add/move all files in the directory you specified plus all directories that exist beneath it. A forth option will appear, "Store volume label into Compressed file? (Y or N)->". This option will allow you to optionally store volume label information into the compressed file. The default is not to store label information. Respond Y if you wish to store the volume label information. If you respond Y a fifth option will appear, "Enter drive letter of Volume label to Save". When this prompt appears enter the letter of the drive you wish to obtain the volume label information from. If you are creating an ARJ file, you will also be asked if you wish to activate the multi-volume option of ARJ. This option allows you to create a compressed file that will span multiple floppy disks. Thus you can create a "backup" compressed file of an entire hard drive, or very large directory. If you indicated that you wanted to Tag files for processing a window will pop-up on the left side of the screen showing all files that matched the filespec you entered. Tag the files you wish to add or move to the new compressed file by pressing the space bar. When you are done tagging file press the return key and all tagged files will be added or moved into the new archive file. SHEZ USER MANUAL Page -47- Please note that some of these options may not appear when you create a compressed file. If the compression program you are using does not support saving directory information the directory information prompts will not appear. CONVERTING FILES Shez has the ability to convert one, or a group of tagged files, from one format to another. First you must get the file or files you want to convert to appear in the filelist window on the left side of the screen. The easiest way to do this is to start up SHEZ and specify on the command line either *.*, *.ZIP, or *.ARC. Then using the cursor keys highlight the file you want to convert and then press the ALT-V key to convert the file. You will then be asked, via a menu, what archive format you want to convert to. Position the highlight bar to the type of compressed file you wish to convert to and press the enter key. You will also be asked if you want to delete the original file after the conversion has been successfully completed. Respond Y or N. The new file will be placed on the same disk and directory that the original file was on. During the conversion process, SHEZ will convert any nested compressed files that is can identify. NOTE: nested compressed files that have been stored with path names will not be converted. Self extracting compressed files also will not be converted. SHEZ can only process compressed nested files that are one level deep. Any nested compressed files that are nested more than one level deep will remain un-touched. To convert numerous files start up SHEZ as above and use the cursor keys to highlight the files you want to convert, then press the space bar to TAG these files. After all files have been tagged press CTL-V to convert all TAGGED files. SHEZ will allow you to easily convert your old ZIP files into the new ZIP imploded format. Simply tag the ZIP files you want to convert and specify that you want to convert them to ZIP files. You will be asked if you want to delete the old compressed files after the conversion process. SHEZ is smart enough not to delete the old compressed file if the have the same file extension as the new files. I.E. when you convert a ZIP file to a ZIP file to take advantage of the new compression format SHEZ will not delete the converted ZIP files even if you told it to delete the old compressed files after converting them. After SHEZ converts a compressed file it will test the converted file for correctness. If the converted file fails this test the converted file will be deleted and the orginial compressed file will remain intact. SHEZ will also allow you to convert old LZH files to the new LHA 2.05 format using the same method of converting a file to itself. SHEZ USER MANUAL Page -48- SUPPORT FOR SELF EXTRACTING FILES SHEZ also lets you view the contents of self extracting files. Files that have been created by the following compression programs are supported: PKARC, PKPAK, PKZIP version .92 thru 2.04, LHARC version 1.12 thru 2.05, PAK version 1.6 thru 2.01, ARC5 and ARC6, ARJ version 2.10, LHA 2.12, SQZ 1.082 1.083. When you display the contents of a self extracting file SHEZ will attempt to identify which compression program was used to generate the self extracting file. SHEZ will place the name of the compression program it has identified as the creator, on the heading line right next to the column titled NAME. In addition to viewing the contents of a self extracting file you may also extract individual files using SHEZ"s extract command. You may also convert the self extracting file back to a normal compressed file using the CTL-V command, or using the pull down menus. You can not alter the contents of a self extracting file. I.E. add, update, freshen, move, etc. The exception to this are self extracting files built by PKZIP. These files you can treat like normal compressed files. You can add, update, move, delete, freshen, etc. SHEZ USER MANUAL Page -49- ENVIRONMENT VARIABLES SHEZ will recognize the following environment variables if they are set: BIOS This will force SHEZ to use BIOS for writing to the screen. MONO This will force SHEZ to run in monochrome mode. SHEZEX You can set this variable to the disk and path where you want SHEZ to write extracted file to. You can reset this default at any time by using the ALT-P command. SHEZWORK This variable may be used to specify a working directory for SHEZ to use instead of SHEZ building one of its own. This directory must be for the exclusive of SHEZ, and must exist prior to invoking SHEZ. WHEN SHEZ TERMINATES ALL FILES IN THE DIRECTORY WILL BE DELETED, INCLUDING HIDDEN AND SYSTEM FILES, BUT THE DIRECTORY WILL NOT BE DELETED. This option was added to allow more flexibility when running SHEZ on a LAN based system. SHEZCMT This variable may be set to specify a default comment file when adding/updating compressed file comment records to a group of tagged files. SHEZCFG This variable points to your SHEZ.CFG file. It is used to carry forward, the SHEZ configuration options. SHEZLOG This variable defines the LOG file that SHEZ will write to when performing a virus check on tagged files from the DOS directory window. If the file does not exist it will be created. If the fill already exists new information will be appended to the existing file. SHEZXMS This variable de-activates SHEZ"s use of XMS memory. It will over-ride the EMS/XMS usage parameters that were set via the SHEZCFG program. Set this variable to any value to de-active XMS memory usage. Example: SHEZXMS=N Don"t use XMS memory. SHEZEMS This variable de-activates SHEZ"s use of EMS memory. It will over-ride the EMS/XMS usage parameters that were set via the SHEZCFG program. Set this variable to any value to de-active EMS memory usage. Example: SHEZEMS=N Don"t use EMS memory. SHEZUSE Using this variable you can over-ride the EMS/XMS memory usage configuration that was setup via the SHEZCFG program. Set this variable to the type of memory you wish SHEZ to use. I.E. E for EMS memory, and/or X for XMS memory. Examples: SHEZUSE=EX Try EMS first then XMS SHEZUSE=XE Try XMS first then EMS SHEZUSE=E Only try EMS memory SHEZUSE=X Only try XMS memroy SHEZUSE=NN Don"t use XMS or EMS memory. SHEZ USER MANUAL Page -50- Examples: SET BIOS=Y SET MONO=Y SET SHEZEX=D:\WORK SET SHEZWORK=C:\SHEZXX\ SET SHEZCMT=C:\COMMENT.DAT SET SHEZCFG=C:\DATA\SHEZ.CFG SET SHEZLOG=C:\LOG\SHEZ.LOG (This tells SHEZ to write extracted files onto the D disk in the \work directory. You can change this at any time after executing SHEZ by using the ALT-P command.) The environment variables BIOS and MONO will override the BIOS and MONO parameters that were entered via the configuration program. SHEZ USER MANUAL Page -51- SETTING ALTERNATE FILE VIEWERS Shez has the capability to activate user specified alternate file viewers when the CTL-ENTER key is pressed. The alternate file viewers are specified in an external file named SHEZ.INI. This file is a plain ASCII text file that indicates to SHEZ what program should be run as the alternate viewer, based on the highlighted file"s extension, when a user pressing the CNTL-ENTER key. The external file, SHEZ.INI, MUST be located in the current directory, or in a directory that is specified in your path statement. SEE APPENDIX 2 FOR A FULL DESCRIPTION OF THE ENTRIES ALLOWABLE IN THE SHEZ.INI FILE. SETTING USER DEFINED PRINTER The SHEZ.INI file also allows you to define up to three user defined printers. Included with each printer definition is it"s name as it will appear on the menu, a required setup string, an optional endup string, the number of character per line to print, and the number of lines per page to print. The format of the required entries in the SHEZ.INI file is shown in APPENDIX 2. SETTING UP USED DEFINED MENU ENTRIES The SHEZ.INI file also allows user defined menu items to be defined. Up to twenty user defined programs and/or batch files can be specified and they will appear on the uSer menu option when selected. See APPENDIX 2 for the format of the entries required in the SHEZ.INI file. Any number of specific file viewers may be specified. When CTL-ENTER is pressed, SHEZ first looks to see of a specific alternate file viewer has been defined for viewing files with a file extension the same of the highlighted file. If one was defined it is activated and used. If a specific viewer has not been defined SHEZ then determines if a "generic" alternate file viewer has been defined. If it has SHEZ uses the "generic" viewer. If no alternate viewer has been defined SHEZ than defaults to using the normal viewer as defined when the SHEZCFG program was used to configure SHEZ. PLEASE NOTE: WHEN SHEZ ACTIVATES ANY ALTERNATE FILE VIEWER IT ALWAYS USES ITS PAGING LOGIC TO SWAP MOST OF ITS CODE OUT OF MEMORY TO GIVE MORE ROOM TO THE ALTERNATE FILE VIEWER. THIS IS NOT A CONFIGURABLE OPTION SO BE FOREWARNED!!!!!!!!!!!! PERFORMING A VIRUS SCAN SHEZ can scan for viruses in files that are contained in compressed files. It can also scan for viruses in files that are contained in embedded compressed files. SHEZ can check an unlimited number of embedded compressed files, only limited by the amount of available disk space assigned to the SHEZ work disk. When performing a virus scan SHEZ will also check for self extracting compressed files and will also check any files contained with the SFX files. SHEZ USER MANUAL Page -52- The first step performed during a virus check is to test the integrity of the compressed file. If the integrity of the compressed file is compromised, all other action on the compressed file will be bypassed, and an error message will be issued. There are two way to perform a virus scan. One is activated from the DOS directory window, and the other is invoked after opening up a compressed file. To perform a virus scan from the DOS directory window, tag the files you wish to check for viruses then press the ALT-Z or CTL-Z keys. This will initiate the scanning process on all tagged files. When virus checking files from the main DOS directory window, SHEZ will create a virus check log file if the environment variable SHEZLOG is defined. For more information on this variable set the section entitled ENVIRONMENT VARIABLE on page 49. The log file will be created if is does not exists, or will be appended to if it already exists. The file will contain a listing of all the compressed files that are being checked, plus a list of all files within the compressed files that will be checked. If a self extracting file is encountered, the log file will post an entry to the log file identifying the SFX file, and what type SFX it is. Each time the log file is opened a time and date stamp line will be written into the file before any scanning occurs. The log file is NOT updated when doing a virus scan from within an opened compressed file, it is only updated/created when doing a scan from the DOS directory window. BBS SYSOP NOTE: When performing a bulk virus scan on a group of tagged files SHEZ operates differently depending on in the SHEZLOG feature is active. If the SHEZLOG feature is NOT active, any errors encountered will cause an error message box to appear on the screen, and all activity will stop until a key is pressed. If the SHEZLOG feature is active, all error messages will be posted to the file pointed to by the SHEZLOG environment variable. No error messages will appear on the screen. Also when operating in this mode, you may cancel the bulk virus scan, after initiating it, by press the ESC key. To perform a virus scan when viewing the contents of a compressed file, simply press the ALT-Z keys. When doing a virus scan from within an opened compressed file, SHEZ will also look for embedded compressed files and will perform the scan on files contained within them. The only exception to this is if you are looking inside an embedded compressed file when you activate the scan, (ALT-Z). Under this condition SHEZ will only check the files contained in the current compressed file. VIRUS CHECKING SELECTED FILES If you wish to only check a few files contained in a compressed file for viruses, tag the files you wish to check then press the ALT-Z key. Only the tagged files will be checked instead of all in the compressed file. VIRUS SCANNING A DIRECTORY SHEZ USER MANUAL Page -53- When in the DOS directory view screen you may also virus scan an entire directory. Simply move the highlight bar to the directory you wish to scan and press the ALT-S keys. SHEZ will use the user defined virus scanning program to scan the files in the highlighted directory. SHEZ USER MANUAL Page -54- THE SGREP PROGRAM The SGREP program, supplied with SHEZ, is used by SHEZ when the ALT-G key is pressed, to scan member(s) of a compressed file for words or phrases. It is included in the SHEZ package . SGREP allows the user to specify two target strings in the search argument. These two target strings are connected with an and, &, or or, "|" separator. Thus allowing the user to search for two different strings, or two strings or words contained on the same line. When the specific string is found, the line in the file that contains the string is written to the stdout DOS device, which is normally the display. SGREP also has the capability to search the specified file(s) for a regular expression. When performing a regular expression search only one target may be specified. See REGULAR EXPRESSIONS below on how to build a regular expression. The output may be redirected to a file or a printer using the normal DOS redirection symbols. The format of the SGREP command line is as follows: SGREP [options] "target(s)" {file(s)...|@file} Where options are: -f display **FILE-NAME for finds only -l line numbers -c case sensitive search -x no logo -e return errorlevel only -p pause when screen is full -v verbose display output -r target is a regular expression @file indicates an ascii file containing a list of file to process. This list MUST include the complete file specification. I.E. The disk, directory, filename, and file extension. The target string(s) must be enclosed in quotes and special characters can be specified as indicated below. Hex byte sequences can be used to search for special non-displayable characters. They are specified using a pair of hexadecimal bytes preceded by a dollar sign,$. EXAMPLES: $23 include is the string #include $252.50 is the string %2.50 $23$24$25 is the string #$% Two targets may be specified using the & and | characters to search for two targets. If the & is used the lines must contain both targets. If the | is used the lines must contain one of the targets. Example: "save|main" line must have save or main to be listed. "save&main" line must have save and main to be listed. The format of the SGREP command line is presented here for documentation purposes only since SHEZ automatically invokes the SGREP SHEZ USER MANUAL Page -55- itself using a predefined set of options. SGREP may be run from the DOS command prompt, or when using the ALT-Y command option of SHEZ. REGULAR EXPRESSIONS The regular_expression defines the pattern to search for. Upper- and lower-case are always ignored. Blank lines never match. The expression should be quoted to prevent file-name translation. x An ordinary character (not mentioned below) matches that character. "\" The backslash quotes any character. "\$" matches a dollar-sign. "^" A circumflex at the beginning of an expression matches the beginning of a line. "$" A dollar-sign at the end of an expression matches the end of a line. "." A period matches any character except "new-line". "*" An expression followed by an asterisk matches zero or more occurrances of that expression: "fo*" matches "f", "fo" "foo", etc. "+" An expression followed by a plus sign matches one or more occurrances of that expression: "fo+" matches "fo", etc. "-" An expression followed by a minus sign optionally matches the expression. "[]" A string enclosed in square brackets matches any character in that string, but no others. If the first character in the string is a circumflex, the expression matches any character except "new-line" and the characters in the string. For example, "[xyz]" matches "xx" and "zyx", while "[^xyz]" matches "abc" but not "axb". A range of characters may be specified by two characters separated by "-". Note that, [a-z] matches alphabetics, while [z-a] never matches. SHEZ USER MANUAL Page -56- THE DUMPMAC PROGRAM The DUMPMAC program is a small program designed to dump a saved macro file to the DOS stdout device, normally the screen, and list the recorded keystrokes in readable form. The command line format is: DUMPMAC macro-file-name The output of the program is self explanatory, and can be used to debug or list unknown SHEZ macro files. SHEZ USER MANUAL Page -57- THE SHEZCFG PROGRAM The SHEZCFG program is now fully menu driven and contains full online help. As you modify information on each screen be sure to press the F10 key to save each entry screen. After going through all the configuration items be sure to select the "A" menu item to save your configuration information. THE SHEZCFG PROGRAM MUST BE RUN TO CREATE A CONFIGURATION FILE OR SHEZ WILL NOT RUN!! After creating a shez configuration file you may place the configuration file into a directory that is specified in your PATH statement. Shez will find its configuration file as follows: If the SHEZCFG environment variable is set SHEZ will use the configuration file that has been specified by the environment variable. If the SHEZCFG environment varialble has not been set Shez will search the directories in your PATH looking for a file named SHEZ.CFG. If a valid configuration file can not be located SHEZ will not run!!!!! CONFIGURING FOR VIRUS SCANNING Under the program options, you will be asked if you wish to configure SHEZ to scan .COM and .EXE files contained in compressed files for viruses. If you respond Y, SHEZ will that ask you where the virus checking program can be found. The programs that SHEZ supports are, SCAN.EXE version 39 or greater, produced by McAfee Associates, and the virus scanning program by Central Point. When prompted enter the complete DISK:\DIRECTORY\FILENAME.EXT of where the virus scanning program is located. It is advised that you place the SCAN program on a write protected floppy disk to prevent it from being infected. You may also optionally enter any additional command line options that the virus scanning program requires. The optional parameters are entered after the SHEZCFG prompts for them. If you use the /report feature of McAfee"s virus scanning program, and you use the SHEZLOG feature, as explained in the section titled PREFORMING A VIRUS SCAN on page 51. PLEASE BE SURE TO specify two different files names. If they are both pointing to the same file the results will be unpredictable. PLEASE NOTE: SHEZ WILL NOT SEARCH YOUR PATH FOR THE SCAN PROGRAM. IF YOU DO NOT TELL IT EXACTLY WHERE TO FIND IT SHEZ WILL BE UNABLE TO EXECUTE THE PROGRAM. COMPATIBILITY ISSUES SHEZ USER MANUAL Page -58- SHEZ achieves fast screen updates buy writing directly to video buffer memory. If your machine is not 100% compatible you can force SHEZ to use BIOS routines to update the screen. This is accomplished by setting an environment variable BIOS equal to Y. I.E. SET BIOS=Y. Do this before executing SHEZ. For monochrome monitors a similar method is employed set the environment variable MONO equal to Y. I.E. SET MONO=Y. Some clone machines have a bug in the builtin BIOS routines that will cause SHEZ to hang if you have exploding windows turned on. If you experience a machine lock up, try reconfiguring SHEZ and turn the exploding windows off. DESQVIEW COMPATIBILITY SHEZ is now DESQview aware. When setting SHEZ up under DESQview set the parameter WRITE DIRECTLY TO SCREEN to NO, and USES OWN COLORS to YES. SHEZ will also automatically release its timeslice to Desqview when waiting for keyboard input. WINDOWS AND OS/2 COMPATIBILITY SHEZ has been tested under Windows 3.1 and OS/2 2.X. When running under OS/2 or Windows enhanced mode, SHEZ will automatically release its timeslice to the operating system when waiting for keyboard input. SHEZ USER MANUAL Page -59- SWAPPING SHEZ OUT OF MEMORY This section briefly describes how SHEZ swaps itself out of memory to make room for other programs. It also describes how the user can configure SHEZ to perform its swapping function. When you configure SHEZ to swap itself out of memory when running other programs, SHEZ first looks to see if your system has EMS or XMS memory installed. If there is EMS or XMS memory, and there is a sufficient amount of EMS or XMS memory, SHEZ will copy most of its code to EMS or XMS memory then free up enough memory to run another program. After the other program has ended SHEZ then swaps itself back into memory. As a default SHEZ will first look to see of XMS memory is available. If XMS is available and there is a sufficient amount of XMS memory SHEZ will swap itself to XMS memory. If XMS memory is not available, or there is not enough XMS memory available, SHEZ will them look for EMS memory. If EMS memory is available, and there is sufficient EMS memory, SHEZ will swap itself into EMS memory. If EMS memory is not available, or there is not enough EMS memory available SHEZ will then swap itself to disk. If EMS or XMS memory is not available, or there is not enough EMS or XMS memory, SHEZ will then use your DISK to swap itself out of memory. It allocates disk space on the currently active drive and in the current directory. When SHEZ swaps to disk it can conflict with some compression operations. To solve this problem the SHEZCFG program allows you to tell SHEZ, HOW AND WHERE TO SWAP itself. The SHEZCFG program allows you to tell SHEZ the DISK and DIRECTORY of where to build its swapper file if it needs to swap to disk. IT IS HIGHLY RECOMMENDED THAT YOU CREATE A SEPARATE AND UNIQUE DIRECTORY ON YOUR HARD DRIVE FOR SHEZ TO USE WHEN SWAPPING TO DISK. THIS DIRECTORY SHOULD NOT HAVE ANY FILES IN THE DIRECTORY. USING THE SHEZCFG PROGRAM, TELL SHEZ THE LOCATION AND THE NAME OF THIS DIRECTORY. THEN IF SHEZ NEEDS TO SWAP TO DISK IT WILL PLACE THE SWAPPER FILE INTO THIS UNIQUE DIRECTORY, AND AFTER THE SWAP FUNCTION IS COMPLETE IT WILL REMOVE THE SWAPPER FILE. The SHEZCFG program also allows you to tell SHEZ to ignore EMS or XMS memory, even if you have EMS and/or XMS memory installed, and always swap to disk. Since these option are new in release 6.1 PLEASE RUN THE SHEZCFG PROGRAM AND SET THE SWAPPING OPTIONS TO YOUR PERSONAL NEEDS. The swapping options can be found under the ADDITIONAL SETUP INFORMATION menu item. You can tell SHEZ to use XMS, EMS, and disk for swapping. If you specify all three XMS will be tested first, then EMS, then disk. USING EMS/XMS MEMORY IN SHEZ SHEZ USER MANUAL Page -60- Beginning with release 7.0 of SHEZ, SHEZ can now use 65K of XMS or EMS memory to reduce its DOS memory requirements. The XMS/EMS memory is used for temporary storage areas, thus reducing the amount of DOS memory SHEZ needs. The XMS/EMS memory will be released when you exit SHEZ. If SHEZ uses EMS memory, it will also use a portion of the allocated EMS memory as a file buffer area when copying files from the DOS directory display. This will significantly speed up the copy operations, so it is recommenced to use EMS memory if it is available. EMS / XMS memory usage can be configured through the SHEZCFG program via the ADDITIONAL SETUP INFORMATION menu item. Shown below is the EMS/XMS configuration option as it will appear on the screen: SHEZ can use EMS or XMS memory to reduce its memory requirements. SHEZ will first try to use EMS and then XMS if EMS memory is not available. You can tell SHEZ to only use EMS, only use XMS, not to use either, or to try XMS first then EMS. At the prompt enter EX to use EMS then XMS, OR enter XE to use XMS then EMS, OR enter E to use only EMS, OR enter X to use only XMS, OR enter to spaces to not use EMS or XMS. Enter EMS-XMS usage as described above->EX You can over-ride the memory usage options through the use of environment variables. See the section titled ENVIRONMENT VARIABLE for more information. SHEZ USER MANUAL Page -61- SPEECH FRIENDLY INTERFACE Release 7.1 of SHEZ implements a new feature called Speech Friendly Interface, (SFI). This feature makes SHEZ more friendly to users with speech synthesizer boards, (these enable the blind users to read the computer display). The SFI interface has been implemented in three parts. In addition the Copyright box will not appear in the upper right corner of the display, leaving the screen a little cleaner. The first SFI feature is that most dialog boxes, error message boxes and informational boxes will be displayed using DOS BIOS routines instead of writing directly to the video buffers. This feature should make interfacing SHEZ to a speech synthesizer a little eaiser. The second SFI feature will position the cursor on the currently active screen line. This feature has been implemented when viewing the DOS directory listing, the compressed files listing, the help screens, and the drop down menu system. When possible the cursor will be placed to the right of the first pertinent data appearing on the screen. However there are some dialog boxes, and prompt boxes that this positioning is not 100% accurate. To solve this problem, the third part of the SFI interface includes the ability to "FREEZE" the screen, and use the cursor keys to walk around the screen. To freeze the screen press the ` (left single quote character). This will place the screen in a frozen state UNTIL YOU PRESS THE ` KEY AGAIN. When the freeze frame is activated a low to high beep sound will be made. When exiting the freeze frame feature a high to low beep will be made. While in the frozen state the following cursor movement keys are active: CURSOR-UP = move cursor up one line CURSOR-DOWN = move cursor down one line CURSOR-LEFT = move cursor left on character CURSOR-RIGHT = move cursor right one character PAGE-UP = move cursor to upper left corner of screen PAGE-DOWN = move cursor to lower left corner of screen CONTROL-HOME = move cursor to first significant character on current line. (A significant character is a character having an ascii code greater then a decimal 20, and less than a decimal 123) HOME = move cursor to where is originally was before you started fussing with it. The SFI support routines are activated by using the SHEZCFG program, and setting the SFI option to Y. 4DOS AND NDOS SUPPORT Shez offers limited support for certain capabilities when running under 4DOS and NDOS. Shez can automatically determine if it is running under either of these systems and will active support for their facilities automatically. The following facilities are supported: SHEZ USER MANUAL Page -62- 1) When viewing a DOS directory display pressing the ALT-D keys will display the 4DOS/NDOS description entries if any exist. 2) When viewing a DOS directory display pressing the ALT-U keys will allow you to UPDATE and/or ADD description entries to the currently highlighted file. This will also active the ALT-D option automatically. When adding a description to a file if the 4DOS/NDOS DESCRIPT.ION file does not exist one will be created, if the file already exists it will be updated. 3) When copying, moving, or renaming files the 4DOS/NDOS description will be carried along with the file. If the file is renamed the entry in the DESCIPT.ION file will be modified accordingly. 4) AT THE CURRENT TIME SHEZ DOES NOT MODIFY THE DESCIPT.ION FILE WHEN YOU DELETE A FILE. THE FILES DESCRIPTION WILL REMAIN IN THE 4DOS/NDOS DESCRIPT.ION FILE. USING 4DOS INTERNAL LIST COMMAND SHEZ can be configured to use the internal LIST command of 4DOS as the default file viewer. To configure SHEZ for this feature, use the SHEZCFG program and select option 5 and press F10 until the menu titled OTHER PROGRAMS TO USE appears. Answer Y to the question, "When running under 4DOS use 4DOS internal list command". You may also enter blanks in the area that asks for the Viewing-program to use. SHEZ USER MANUAL Page -63- SUPPORT FOR SPANNED ZIP FILES SHEZ now offers support for ZIP files that span multiple floppies. Due to the nature of these types of ZIP files SHEZ will limit the operations that can be performed on spanned ZIP files. SHEZ will allow you to create spanned ZIP files and extract from spanned ZIP files, but SHEZ will not allow you to modify the ZIP file after it is created. You may not ADD, DELETE, RENAME, CONVERT, or add comments to the spanned file. If you attempt to perform an illegal operation SHEZ will display a dialog box informing you that the operation selected can not be performed. Also it should be noted that SHEZ, in it's current release, can only handle a maximum of 3500 files per compressed file. If you create a spanned ZIP file containing more than 3500 files SHEZ can only process the first 3500 files it finds in the ZIP file. Normally when you extract files from a spanned ZIP file PKUNZIP will ask that you insert the last disk of the backup set first. SHEZ operates just the reverse. When reading spanned ZIP files SHEZ will ask that you insert the first disk of the backup set and each subsequent disk. In effect it reads the ZIP from front to back. This may seem strange, but when SHEZ is done reading the spanned ZIP file the last disk of the backup set will already be in the drive, so when you perform an extract you will not have to insert the last disk of the set as required by PKUNZIP. Support was added for spanned ZIP files due to numerous user requests. If you are using the spanned disk feature to backup a hard drive please keep in mind that SHEZ will only be able to handle a maximum of 3500 files in the ZIP file. SUPPORT FOR UC2 COMPRESSED FILES SHEZ now offers support for UC2, Ultracompressor II, type compressed files. SHEZ can convert to/from UC2 compressed files to/from any other compressed file format without the need of the file conversion .BAT files that are distributed with the UC2 package. There is a special menu item that allows you to configure the UC2 program via it's internal configuration option. The menu item is contained in the Opts main menu and is titled, FULL UC2 CONFIGURATION. When configuring SHEZ please be sure to specify the UC.EXE file as the program to run when processing UC2 type compressed files. Since SHEZ has it's own memory management routines builtin you do not need to use the Stealth technology that is available in the UC2 package. SHEZ does support FRESHEN and UPDATE commands if you are running release 2 of UC2.. SHEZ does support the storing and retrieval of "file versions" as documented in the UC2 manual. It also supports storing and retrieval of files stored in directories within UC2 files. SUPPORT FOR WINDOWS TYPE COMPRESSED FILES Shez supports the viewing and expanding of Windows type compressed files. Most of these type files have an underscore in the file extension. Shez uses the "native" EXPAND.EXE program to expand the compressed file. The EXPAND.EXE program must be located in a directory that is specified in your path statement. If it is not you must copy the file to a directory that is listed in your path SHEZ USER MANUAL Page -64- statement. The 10.3 release of SHEZ handles these files differently than the 10.2 release of SHEZ. To view a windows type compressed file. Highlight the file in the DOS directory screen of SHEZ and press the enter key. SHEZ will display the compressed and expanded file sizes. Press the enter key again and SHEZ will invoke the default file view program allowing you to view the file. To expand the compressed file, instead of pressing the enter key, press the E key to expand the file. During both of these processes SHEZ will prompt you for a character to replace the underscore character in the file extension. SUPPORT FOR INFOZIP ZIP AND UNZIP If you are using the INFOZIP ZIP and UNZIP programs you must run the SHEZCFG program and under the Program setup screen set the INFOZIP field to a Y. If this is not donw SHEZ will think you are using the PKZIP and PKUNZIP programs. SHEZ USER MANUAL Page -65- WHERE TO FIND THE MOST CURRENT VERSION The following BBS"s are distribution points. In addition you can leave mail on these system for me if you need technical assistance. Space BBS (415)323-4398 Main Distribution and Mail point. Kandy Shack (714)636-2667 Main Distribution and Mail point. Crackers Paradise (707)838-4483 Alternate Distribution and Mail. Internet FTP site ftp.sonic.net/pub/users/jderr Additional Distributions Points. EXEC-PC (414)964-5160 MicroSellar (201)239-1346 Vern Buerg"s Bit Boutique (707)778-8944 Comupserve In the IBMSYS Forum Library 6, keyword of SHEZ SHEZ can also be found on the internet in the Simtel Software Repository and its mirror sites. ftp.coast.net SHEZ can be found in the directory /msdos/arcutil with a filename of SHEZxxx.ZIP where xxx is the version number. OVERSEAS AGENT Ensing BBS Postbus 4 NL-9617 ZG Harkstede The Netherlands Gert Ensing is the sysop and is also an Overseas Agent for registration of SHEZ. +31 5904-1913 +31 5904-1388 +31 5904-2135 +31 5904-2733 SHEZ USER MANUAL Page -66- ASP HUB NETWORK In an effort to make it easier for you to obtain your favorite software, the latest updates of many ASP authored programs can be found on the BBSs listed below. These BBSs are members of the ASP Hub Network (AHN). Zone 1 - East Coast USA North-East Coast Mid-East Coast [Site #1] [Site #2] The Consultant BBS The Break RBBS Jay Caplan Bruce Jackson P.O. Box 8571 4660 Whitaker PL New York NY 10116-4655 Dale City, VA 22193-3011 Data1) 718-837-3236 Data1) 703-680-9269 Data2) Data2) 703-551-0000 Zone 2 - North Mid-USA Zone 3 - Southern Mid-USA [Site #3] [Site #4] The Twilight Zone The DataExchange BBS John Hrusovszky Don Morris 1119 E. Main St 119 Herring St. Auburndale, WI 54412 Leesville, LA 71446 Data1) 715-652-2758 Data1) 318-239-2122 Data2) Data2) Zone 4 - West Coast USA [Site #5] [Site #6] Attention to Details BBS Space BBS Clint Bradford Owen Hawkins 5085 Trail Canyon Dr PO Box 260 Mira Loma CA 91752 Menlo Park, CA 94026 Data1) 714-681-6221 Data1) 415-323-4398 (1) Data2) Data2) 415-323-4193 (2) Zone 5 - Canada (1) ASP file downloading only (2) ASP author uploading & [Site #7] main public BBS number. Knightec BBS Phil Knight 35 Robb Blvd #6 Orangeville, ONT L9W 3L1 Data1) 519-940-0007 Data2) These BBSs are bound by special agreement with the ASP. In the case of a dispute contact the ASP Omsbudsman. SHEZ USER MANUAL Page -67- SUPPORT FOR SHEZ AND QUESTIONS Support can be obtained in three ways. If you have access to CSERVE please send your questions to me via Easyplex. (type GO MAIL at the Cserve prompt) My userid is 76266,2634. This is the preferred method, I check for mail twice a week and will get back to you with an answer usually within a week. You may also contact me via the GENIE network, my GENIE mail id is J.DERR1. If you do not have access to CSERVE or GENIE send a note, letter, postcard to the address show below. Register users have priority but I will try to help anyone in need. Support can also be obtained via the INTERNET. Send your questions or comments to JIM.DERR@SPACEBBS.COM. You may also receive support by calling California Software Design at (707) 575-9868. California Software Design P.O. Box 15248 Santa Rosa, CA 94502 SHEZ USER MANUAL Page -68- COMMANDS SORTED BY DESCRIPTION ALT-D . . . . 4DOS/NDOS description display ALT-A . . . . Add a list of files ALT-A . . . . Modify file Attributes A . . . . . . Add file(s) to compressed ALT-C . . . . Add/update file comments S . . . . . . Add\Update comment records for highlighted file SFT-S . . . . Add\Update file records for all files in compressed file. CTL-ENTER . . Alternate File Viewer ALT-B . . . . Browse any file ALT-Z . . . . Check files in all tagged compressed files for viruses. CTL-Z . . . . Check files in all tagged compressed files for viruses, . . . . . . . plus strip comments out of any tagged .ZIP files. ALT-Z . . . . Check for viruses CTL-V . . . . Convert all tagged archive files to another format. ALT-V . . . . Convert highlighted archive file to another format. CTL-V . . . . Convert sfx file. CTL-F2 . . . Copy highlighted file CTL-F2 . . . Copy tagged files CTL-Y . . . . Copy tagged files from one Compress file to another. F7 . . . . . Create new compressed file ALT-D . . . . Delete all extracted files SFT-F4 . . . Delete all tagged files F4 . . . . . Delete highlighted file/Dir D . . . . . . Delete highlighted file CTL-D . . . . Delete tagged files Enter . . . . Display directory contents or Display file contents. / . . . . . . Display menu bar ALT-P . . . . Drive:path to extract into F8 . . . . . EDIT SELECTED FILE ALT-N . . . . Extract all NEWER files ALT-X . . . . Extract all files CTL-E . . . . Extract all tagged files ALT-E . . . . Extract specified file(s) E . . . . . . Extract the highlighted file ALT-0 . . . . Flush macro ALT-F . . . . Freshen a list of files F . . . . . . Freshen file(s) in compressed F1 . . . . . HELP TAB . . . . . Hot directory display ALT-Q . . . . Immediately exit SHEZ CTL-X . . . . Immediately exit to extract path ALT-8 . . . . Load and run macro ALT-7 . . . . Macro Playback ALT-5 . . . . Macro pause F8 . . . . . Make Self Extracting file from highlighted file SFT-F8 . . . Make Self Extracting files from all tagged files. / . . . . . . Menu display ALT-M . . . . Move a list of files M . . . . . . Move file(s) to compressed CTL-F3 . . . Move highlighted file SFT-F3 . . . Move tagged files G . . . . . . Password for compressed file CTL-P . . . . Print functions CTL-F6 . . . Rename file SHEZ USER MANUAL Page -69- SFT-F6 . . . Rename tagged files ALT-R . . . . Reread the directory. ALT-G . . . . Run GREP against file(s) ALT-Y . . . . Run a program against tagged file(s) ALT-F . . . . Run PKZIPFIX against currently highlighted file. R . . . . . . Run the highlighted file Z . . . . . . SPECIFY compressed FILE MASK ALT-9 . . . . Save macro to file F5 . . . . . Execute highlighted program file I . . . . . . Show info about archive file ALT-F2 . . . Smart copy ALT-F2 . . . Smart Extract ALT-F3 . . . Smart move F9 . . . . . Sort archive listing F6 . . . . . Sort the file display P . . . . . . Specify Path options ALT-S . . . . Speed search ALT-6 . . . . Start/Stop macro recording F2 . . . . . Switch to another archive File or directory CTL-SPACE . . Tag all files CTL-T . . . . Tag all files. + . . . . . . Tag highlighted file ALT-+ . . . . Tag highlighted file F10 . . . . . Temporary exit to DOS T . . . . . . Test archive integrity F6 . . . . . Toggle $.$ and *.* ALT-1 . . . . Toggle authenticity mode O . . . . . . Toggle overwrite for extract SPACE . . . . Toggle tag status ALT-T . . . . Toggle tagged file status line CTL-U . . . . Untag all files - . . . . . . Untag highlighted file ALT-- . . . . Untab hightlighed file ALT-U . . . . Update a list of files CTL-T . . . . Update archive file time&date U . . . . . . Update file in archive ALT-F8 . . . UUENCODE file(s) CTL-F8 . . . UUDECODE file(s) ALT-V . . . . View file comment records CTL-D . . . . View FILE_ID.ZIP file F3 . . . . . View highlighted file V|RET . . . . View the file ALT-S . . . . Virus scan highlighted directory. ALT-W . . . . Write SHEZ.CFG file. ALT-M . . . . ZOOM / UNZOOM DOS Directory window SHEZ USER MANUAL Page -70- LICENSING SHEZ FOR PERSONAL USE Shez is marketed as a shareware program. This marketing method gives the user the opportunity to evaluate the program before actually registering the software. If after a two week evaluation period you determine that SHEZ meets your needs, you are required to register your copy of SHEZ with California Software Design. To register your copy of SHEZ, complete the registration form that is distributed with the SHEZ package, include your payment and mail to California Software Design, P.O. Box 15248, Santa Rosa, CA 95402. You may also register SHEZ via the Compuserve shareware registration service. See the SHEZ.REG file included with this package for information on how to use this service. When your registration form is processed you will be mailed an individual serial number, along with a receipt for your registration fee. CORPORATE SITE LICENSING FOR SHEZ A license is required for use of SHEZ by corporations and institutions. You may obtain a license for the use of SHEZ by writing to me. The license is for perpetual, nonexclusive use of any version. Purchase orders and invoicing are acceptable. A license agreement form will be sent upon request. You may use it, or supply your own for my review. There are no restrictions to the number of sites, or for use on local area networks. If you have special requirements, or need customization, please feel free to submit them in writing. You may request a license for: 1) A fixed number of copies, see the discount schedule; 2) An unlimited number of copies, the minimum fee is $1200; 3) Customization of messages and documentation, an additional fee may be required depending on the extent of changes; 4) Permission to distribute within your organization; The fee for a license depends on the estimated number of copies of the program that you will use. To use the discount schedule below, estimate the total number of copies that you may eventually use. Number of users(copies) Price per copy 1 to 10 $39.00 11 to 30 $35.00 31 and up $31.00 Please contact California Software Design for site license prices. Regardless of the quantity, only one set of materials will be sent to you. You may then make as many copies of it that are licensed. Upgrades will be made available upon request. Technical support is available via mail, or contacting me via Compuserve 76266,2634, OR via Internet. My internet address is jderr@sonic.net SHEZ USER MANUAL Page -71- APPENDIX - 1 - ERROR CODES ERROR CODES WHEN ATTEMPTING TO SWAP 0 No errors occurred. 1 Unable to read temp file back to memory. 2 Temp file is missing on restore! 3 Can't unallocate memory. 4 Too many open files. 5 Access Denied. 6 Can't locate COMMAND.COM. 7 Memory control blocks are damaged. 8 Not enough memory to reload the original program. 9 Error reading EMS. 10 Not enough disk space. 11 Invalid Drive. 12 Error writing the file. 14 Too many file handles! 15 Bad path. 16 File exists. 17 Interrupt(s) changed during swap. 18 To many MCB's. 19 Not enough memory to load the command interpreter. >255 At least one unsafe interrupt has been encountered. PKZIP ERROR CODES 1 :Bad file name of file specification 2-3 :Error in ZIP file 4-11 :Insufficient memory 12 :No files were found to add to the ZIP file or no files were specified for deletion. 13 :File not found. The specified ZIP file or list file was not found. 14 :Disk full 15 :Zip file is read-only and can not be modified. 16 :Bad or illegal parameters specified. 17 :Too many files. PKUNZIP ERROR CODES 1 :Warning error (such as failed CRC check) 2-3 :Error in ZIP file 4-8 :Insufficient memory 9 :File not found. No zip files found. 10 :Bad or illegal parameters specified. 11 :No files found to extract/view etc. 50 :Disk full 51 :Unexpected end of file in ZIP file. SHEZ USER MANUAL Page -72- ARJ ERROR CODES 1 :Warning Specified file to add not found Specified file to list, extract, etc., not found or answering negatively to "OK TO PROCEED TO NEXT VOLUME" prompt 2 :Fatal error 3 :CRC error 4 :ARJ-SECURITY error or attempt to update an ARJ-SECURED archive. 5 :Disk full or write error 6 :Can"t open archive or file 7 :Simple user error (bad parameters) 8 :Not enough memory LHARC ERROR CODES 1 :CRC error 2 :Fatal error. 3 :Failed to write tempory files in the archive. PKUNPAK ERROR CODES 1 :Bad CRC warning 2 :Out of memory 3 :No archives found to extract 4 :Can"t open archive file 5 :Read error on archive 6 :Internal table overflow 7 :Disk Full PAK ERROR CODES 1 :CRC error 2 :Out of memory 7 :Disk Full SHEZ USER MANUAL Page -73- ERROR CODES WHEN FORMATTING A DISK 1 :Invalid disk parameter 2 :Address mark not found 3 :Write protect error 4 :Requested sector not found 6 :Disk change line active 7 :Wrong capacity for drive 8 :DMA overrun 9 :DMA boundary error 10 :Bad disk/cap=1.4 w/720k disk or write protected disk 11 :Bad sectors found and marked 12 :Drive type not supported. 12 :Media type not found 16 :CRC read error 32 :Controller failure 64 :Seek failure 128 :Drive door is open CRITICAL SYSTEM ERROR CODES 0 :Write Protect Error 1 :Invalid Drive Specified 2 :Drive Not Ready 3 :Invalid Command 4 :CRC Error 5 :Bad Request Structure Length 6 :Seek Error 7 :Unknown Medium 8 :Sector Not Found 9 :Printer Out Of Paper 10 :Write Error 11 :Read Error 12 :General Failure SHEZ USER MANUAL Page -74- APPENDIX - 2 - SHEZ.INI FILE ;******************************************************************** ; SHEZ External viewer specification file. * ; (SAMPLE FILE ONLY!!!!!) * ; * ; AFTER MODIFYING THIS FILE IT MUST * ; BE RENAME TO: * ; SHEZ.INI * ; AND THEN COPIED TO A DIRECTORY THAT IS * ; IN YOUR PATH STATEMENT. * ; * ; * ;FORMAT OF FILE: * ; Each line must end with a Carriage return, Line feed. * ; Everything to the right of a semicolon treated as comments. * ; * ; External viewer programs are specified as follows: * ; EXT = PROGRAM * ; WHERE ext is the file extension (DO NOT ENTER THE PERIOD!) * ; program is the program to execute based on the selected * ; file extension. * ; $f indicates to SHEZ where to place the filename * ; when executing the program. * ;EXAMPLE: * ; C=E:\UTY\QEDIT.EXE $F * ; * ; If the highlighted file in SHEZ is HELP.C then SHEZ will * ; attempt to execute E:\UTY\QEDIT.EXE HELP.C * ; * ;******************************************************************** ; ADVANCED FEATURES * ; * ;SPECIFYING A STARTUP DIRECTORY: * ; To tell SHEZ to change to a specific directory before running * ; the specified external file viewer use the vertical bar * ; character to separate the startup directory name from the * ; viewer command as shown below: * ; * ;GIF=E:\GIF\VPIC.EXE $F|G:\GIF\VPIC * ; * ; * ;TELLING SHEZ TO PAUSE AFTER RUNNING THE VIEWER: * ; SHEZ can pause before returning to itself allowing you to * ; view the contents of the screen after the external viewer * ; has been executed. This is accomplished by placing the * ; character immediately after the equal sign. * ; * ;GIF=~E:\GIF\VPIC.EXE $F|G:\GIF\VPIC * ; * ; * ;******************************************************************** [External Viewers] ;THIS IS A REQUIRED ENTRY, TELLS SHEZ WHERE ;THE EXTERNAL VIEWER DATA BEGINS generic=list.com $f ;This is a generic viewer it will be executed if SHEZ USER MANUAL Page -75- ;the highlighted file's extension is not specified, ;or there is no file extension. H =Q.EXE $f ;Run q.exe for file with .h extension DOC=E.EXE $f ;Run e.exe for file with .doc extension WP =WPVIEW.EXE $F ;Run wpview.exe for file with .wp extension C=E.EXE $F ;Run e.exe for file with .c extension SHEZ USER MANUAL Page -76- ;******************************************************************** ; SETTING UP PRINTERS * ; * ;Up to three user defined printers can be defined. Each printer * ;definition requires it's own section name. The section name * ;is: [PRINTERx] where x is 1,2, or 3. * ;Each printer section must have the following keyword defined: * ; * ;NAME * ; user defined name of printer (25 characters or less) * ;SETUP * ; printer setup string * ;CHARS-PER-LINE * ; maximum number of characters per line * ;LINE-PER-PAGE * ; maximum number of lines per page * ;ENDUP * ; printer endup string (THIS IS OPTIONAL) * ; * ;The printer SETUP and ENDUP strings can be up to 100 characters in * ;length. The strings CAN NOT contain carriage return or line feed * ;characters. If these must be included in the string use the $ * ;character to enter their HEX equivalent. I.E. a carriage return * ;would be entered as $0d. The $ character indicates to SHEZ that the* ;next two characters are to be interpreted as HEX. For example to * ;enter the ASCII ESC character into the setup string use the * ;following in your string: $1b. * ; * ;Each printer definition can also optionally use the PORT keyword * ;to define which LPT port use. If the PORT keyword is used the * ;only valid values are LPT1 through LPT9. If the PORT keyword is * ;not used SHEZ will then use the LPT port as defined in the SHEZCFG * ;program. * ;EXAMPLE: to print to port 3: * ;PORT=LPT3 * ;******************************************************************** [Printer1] ;HPLASER II-IV portrait compressed name=HP-port-compress setup=$1bE$1b(10U$1b(s16.6H$1b&l8D endup=$1bE chars-per-line=132 lines-per-page=80 port=LPT2 [Printer2] ;HPLASER II-IV landscape compressed name=HP-land-compress setup=$1bE$1b&l1O$1b(10U$1b(s16.6H$1b&l8D endup=$1bE chars-per-line=174 lines-per-page=64 SHEZ USER MANUAL Page -77- ;****************************************************************** ; SETTING UP USER MENUS * ; * ;Up to 20 user defined menu items may be defined in this section. * ;Each menu item MUST have a NAME parameter and a PROGRAM parameter* ;defined. The NAME parameter is the text that will appear drop * ;down menu when the uSer menu option is selected. The PROGRAM * ;parameter defines what program or batch file will be executed * ;when the item is selected. The rules for defining these two * ;keyword parameters are as follows: * ; * ;NAME * ; User defined text of 25 characters or less. This text will * ; appear on the drop down menu. * ; * ;PROGRAM * ; The program or batch file to execute when the selection is * ; chosen. * ; * ; * ;SPECIFYING A STARTUP DIRECTORY: * ; To tell SHEZ to change to a specific directory before running * ; the specified user program use the vertical bar character to * ; separate the startup directory name from the program/batch * ; file to execute as shown below: * ; * ; PROGRAM=E:\GIF\VPIC.EXE|G:\GIF\VPIC * ; * ; * ;TELLING SHEZ TO PAUSE AFTER RUNNING A PROGRAM * ; SHEZ can pause before returning to itself allowing you to view* ; the contents of the screen after the program has been * ; executed. This is accomplished by placing the ~ character * ; immediately after the equal sign. * ; * ; PROGRAM=~E:\GIF\VPIC.EXE|G:\GIF\VPIC * ; * ;PASSING A FILE TO A USER DEFINED PROGRAM * ; By using the $f variable when defining the PROGRAM to execute * ; you can pass the currently highlighted filename to an external* ; program. The $f tell SHEZ where to place the filename when * ; launching a user specified program. * ; * ; Two other variables can also be used, the $a and $m variable. * ; These variables only have meaning if you launched a user menu * ; item when selecting a member of a compressed file. The $a * ; variable will be replaced with the full compressed filename, * ; and the $m variable will be replaced with the name of the * ; selected member within the compressed file. For example: If * ; you are looking the contents of compressed file * ; D:\DOWN\SHEZXX.ZIP the highlighted item is SHEZ.EXE then the * ; $a variable will be replaced with D:\DOWN\SHEZXX.ZIP and the * ; $m variable will be replaced with SHEZ.EXE. * ; * ; The $f will also work when viewing the contents of a * ; compressed file. When viewing the contents of a compressed * ; file, if the $f characters are defined in the PROGRAM * ; specification, the highlighted file is extracted to a work * ; directory and the user program is launched. When the user * SHEZ USER MANUAL Page -78- ; program is exited, SHEZ will then check the extracted works * ; file's time and date stamp. If the work file was updated SHEZ* ; will REFRESH the copy of the file in the compressed file. * ; * ; THERE ARE FIVE ADDITIONAL VARIABLES THAT CAN BE USED. * ; $CD will be replaced by the current drive, including the * ; colon. I.E. D: * ; $CP will be replaced by the current path, including the * ; trailing backslash. I.E. \UTILITY\ * ; $ED will be replaced by the extract drive, including the * ; colon. I.E. D: * ; $EP will be replaced by the extract path, including the * ; trailing backslash. I.E. \EXTRACT\ * ; $? will tell SHEZ to prompt the user for the information * ; to replace. * ; * ;****************************************************************** SHEZ USER MANUAL Page -79- [User-menu] Name=WordPerfect 5.1 Program=E:\APPS\WP51\WP.EXE /nk|E:\APPS\WP51 Name=WordPerfect 5.1 (pass file) Program=E:\APPS\WP51\WP.EXE $f /nk|E:\APPS\WP51 Name=WordPerfect 6.0 Program=U:\WP60\WP.EXE /nk|U:\WP60 SHEZ USER MANUAL Page -80- INDEX (Plus key +) 21, 34 4DOS 8, 22-24, 26, 61, 62, 68 4DOS AND NDOS SUPPORT 61 Activate volume label processing 22, 35 ACTIVATING THE MENU SYSTEM 9 Add Update File Comments 32 Add volume label to existing compressed file 35 Add/Update all archive file comments 33 Add/Update compressed file comments 20 Add/Update highlighted archive file comments 33 ALT-1 21, 34, 69 ALT-4 41 ALT-5 43, 68 ALT-6 43, 44, 69 ALT-7 68 ALT-8 68 ALT-9 44, 69 ALT-A 68 ALT-B 68 ALT-C 68 ALT-D 68 ALT-E 68 ALT-F 68 ALT-G 43, 69 ALT-M 68 ALT-N 68 ALT-P 68 ALT-Q 68 ALT-R 69 ALT-S 69 ALT-T 69 ALT-U 69 ALT-V 68, 69 ALT-W 69 ALT-X 68 ALT-Y 69 ALT-Z 68 Alternate file viewers 17, 21, 33, 51 APPENDIX -2- SHEZ.INI FILE 74 ARJ ERROR CODES 72 ASP HUB NETWORK 66 BBS SYSOP NOTE: 52 Browse any file 22, 35, 68 CFG 19, 49, 50, 57, 69 COMPATIBILITY ISSUES 57 configuration 6-8, 19, 20, 28, 31, 33, 49, 50, 57, 60, 63 CONFIGURING FOR VIRUS SCANNING 57 Convert all tagged files 18, 47 Convert highlighted file 18 Convert highlighted file to a SFX file 18 Convert SFX file 33, 68 Convert Tagged files to SFX files 19 CONVERTING FILES 47 Copy all TAGGED DOS files 21 Copy highlighted file 19, 68 CORPORATE SITE LICENSING FOR SHEZ 70 Create a new archive file 16, 31 CREATING NEW COMPRESSED FILES 16, 31, 41, 46 SHEZ USER MANUAL Page -81- CRITICAL SYSTEM ERROR CODES 73 CTL-E 68 CTL-ENTER 68 CTL-F2 19, 68 CTL-F3 68 CTL-F6 68 CTL-SPACE 69 CTL-T 69 CTL-U 69 CTL-V 68 CTL-X 68 CTL-Z 68 DEL KEY 22, 36 Delete a DOS file or empty directory 17 Delete all extracted files 30, 68 Delete all TAGGED DOS files 21 Delete highlighted / tagged file(s) 22, 36 DESQVIEW 16, 17, 31, 58 DESQVIEW COMPATIBILITY 58 Directory Assistance 4 Display Info about archive file 28 DOS directory Speed Search 16 Edit highlighted file 21 Edit the selected file 31 EDITING KEY DEFINITIONS 15 EMS 7, 49, 59, 60, 71 ENVIRONMENT VARIABLES 49, 50, 60 ERROR CODES WHEN ATTEMPTING TO SWAP 71 ERROR CODES WHEN FORMATTING A DISK 73 ESC 7, 9, 12, 15, 18, 22, 26, 34, 35, 37, 43, 44, 52, 76 Execute a file in an archive file 30 Execute highlighted program 23, 69 Exit SHEZ 20-22, 30, 34, 36, 39, 60, 68 Exit SHEZ goto EXTRACT dir 21, 34 Extract all files from archive 30 Extract all tagged files 30, 68 Extract location 8, 16, 26, 30, 41, 42 Extract only newer files 33 Extracting a single file 28 F1 6, 16, 24, 26, 31, 40, 68 F10 16, 29, 31, 34, 57, 62, 69 F2 17, 19, 21, 25, 31, 68, 69 F3 17, 19, 21, 26, 68, 69 F4 17, 21, 23, 26, 68 F5 23, 69 F6 19, 21, 22, 68, 69 F7 16, 31, 41, 46, 68 F8 18, 19, 26, 31, 37, 68, 69 F9 9, 16, 17, 25, 29, 31, 34, 37, 46, 69 FLOATING EXTRACT LOCATION 41 FLOPPIES 23, 36, 42, 63 FORMATTING 23, 36, 42, 73 FUNCTIONS WHEN VIEWING CONTENTS OF ARCHIVE FILE: 28 HOT DIRECTORY 22, 35, 68 Immediate Exit 20, 30 INTERNAL QUICK-VIEWER 15 KEYSTROKE RECORDING/PLAYBACK 8, 22, 35, 43 label 18, 22, 35, 41, 42, 46 LEFT-MOUSE-BUTTON 9 SHEZ USER MANUAL Page -82- LHARC ERROR CODES 72 LICENSING SHEZ FOR PERSONAL USE 70 LIMIT OF LIABILITY 4 Modify file attributes 23, 68 mouse 9-15, 18, 43 MOUSE SELECTABLE ITEMS IN A DIALOG BOX 11 MOUSE SUPPORT 9, 15 Move all TAGGED DOS files 21 Move highlighted file 19, 68 NAVIGATING A SCROLLABLE DIALOG BOX USING THE MOUSE 11 NDOS 22, 23, 61, 62, 68 NOTES ON CREATING SFX FILES 18 PAK ERROR CODES 72 PERFORMING A VIRUS SCAN 51 PKUNPAK ERROR CODES 72 PKUNZIP ERROR CODES 71 PKZIP ERROR CODES 71 PKZIPFIX 22, 69 playback 8, 22, 35, 40, 43-45, 68 Print directory of compressed file 40 QUICK START 6 QUICKVIEW 13, 15, 23, 36 record 20, 22, 35, 43, 44 Rename all TAGGED DOS files 21 Rename highlighted file 19, 36 Right and Left cursor keys 23, 34 RIGHT-MOUSE-BUTTON 9 Run a program against all tagged files 35 Scan file(s) for a string 35 Select a new archive file 17, 31 Set ARJ Compression Method 39 Set Path/Directory option 32 Set ZIP Compression Method 39 SETTING ALTERNATE FILE VIEWERS 51 SETTING UP USED DEFINED MENU ENTRIES 51 SETTING USER DEFINED PRINTER 51 SFT-F3 68 SFT-F4 68 SFT-F6 69 SFT-F8 68 sgrep 35, 54, 55 SHEZEMS 49 SHEZUSE 49 SHEZXMS 49 Show help screen 16, 31 Show tagged file count 34 Smart copy 25, 69 Smart extract 69 Sort the archive file list 31 Sort the file list 17 spanned 63 Specify an archive file mask 32 SPEECH FRIENDLY INTERFACE 61 Speed search 16, 30, 69 Supply Password for File 32 SUPPORT FOR SELF EXTRACTING FILES 48 SUPPORT FOR SHEZ AND QUESTIONS 67 SUPPORT FOR UC2 COMPRESSED FILES 63 TAB KEY 22, 35, 36 SHEZ USER MANUAL Page -83- Tag All Files 20, 30, 69 Tag highlighted file 21, 34, 69 Temporary exit to DOS 16, 31, 69 Test COM,EXE, and OVL files in a compressed file for viruses 33 Test tagged compressed file(s) for viruses 20 Testing archive integrity 28 THE SHEZFG PROGRAM 30 Toggle authenticity mode in PKZIP 21, 34 Toggle overwrite mode 32 Toggle the Tag status 19, 30 Ultravision 42 Untag all Files 20, 30, 69 Untag highlighted file 21, 34, 69 USING 4DOS INTERNAL LIST COMMAND 62 USING EMS/XMS MEMORY IN SHEZ 59 USING THE MOUSE WITH VERN BUERG'S LIST PROGRAM 15 UUDECODE 26, 37, 69 UUENCODE 26, 37, 69 UUENCODE and UUDECODE 39 View a file 13, 17 View file and archive comment records 33 Viewing a file 15, 28 virus 4, 5, 20, 24, 33, 39, 49, 51-53, 57, 69 VIRUS CHECKING SELECTED FILES 52 Virus scan ALL files 39 Virus scan ONLY EXECUTABLE files. 39 VIRUS SCANNING A DIRECTORY 52 viruses 20, 24, 33, 39, 51, 52, 57, 68 volume 18, 22, 35, 41, 42, 46, 72 VOLUME LABEL SUPPORT 22, 35, 41 WHERE TO FIND THE MOST CURRENT VERSION 65 WINDOWS AND OS/2 COMPATIBILITY 58 Write out configuration information 19 XMS 7, 49, 59, 60 ZOOMING DIRECTORY WINDOW WITH MOUSE 10