VCD.EXE A Change Directory program for OS/2 and DOS. Copyright 1989-1992 Les J. Ventimiglia. All rights reserved. _____________________________________________________________ VCD (Ventimiglia Change Directory) is an enhanced change directory utility featuring a full screen mode and a command line pop-up window for similar name directory changes. VCD makes changing directories very easy. Accessing directories anywhere on your disk is greatly simplified. Using VCD _________ VCD [/rn] [d:][path] Where : /r = Causes a complete rescan of the specified drive. /n = Do not write the VCD data file. d: = Drive to scan. path = partial path to change to. Only the portion after the last \ is used. An invalid option will display the usage. / options can be combined or be specified separately before or after any of the filespecs. /rn == /n/r == /r /n ****************************************************************** * * * Note: Protected mode usage must use the command file VCD.CMD,* * using the executable in protected mode without the * * command file will look like it is changing to the * * directory but will not due to OS/2 restoring the * * environment when the program is finished running. * * * * In case someone tampers with this zip file and deletes * * the vcd.cmd file from it, the cmd file should look * * as follows: * * * * @echo off * * vcdpgm %1 %2 > c:\vcdx.cmd * * if errorlevel 1 goto end * * call c:\vcdx.cmd * * :end * * del c:\vcdx.cmd * * * * * * * ****************************************************************** Operation _________ VCD will rescan the specified or implied disk in the following instances: - The VCD database does not exist or - The /r (Rescan) option is specified or - The current directory of the specified disk is not in the VCD database. VCD will not save the database when used on drives A: or B: or if the /n (nosave) option is used. The database file is written to the root directory of the specified or implied drive using the name "VCD_data". If the drive is write protected (as some network drives are), VCD will attempt to save the database on drive C: using the name "VCD_x.dat" where x is the drive letter. VCD is designed to keep the database for each drive on the root directory of that drive. Scanning never crosses drives. I chose to do this to support removable hard drives, such as the Tandon Personal DataPacs. If I were to scan all drives and keep the database on drive c: (as someone's DOS imitation does), it would not find a directory on a drive that has been ejected and replaced by another. Keeping the database on each drive also allows for faster searches for the desired directory. If [path] is specified on the command line, VCD will do the following: - VCD scans the entire tree for a match to [path]. - If there is only one match, then VCD will change to that directory. - If there are no matches, then VCD will remain in the current directory. - If there are multiple matches, VCD will first check for one exact match. If there is one exact match, VCD change to that directory. Otherwise, VCD will popup a box containing the choices. Move the highlight to the one you want to reach and press to select it, VCD will change to that directory. Command line EXAMPLES: To change to your INCLUDE directory on the current drive and rebuild the VCD data file: VCD include /r or VCD /r include To change to the \bin directory on drive c: VCD c:bin If the [path] option is not specified, VCD will start up in full screen mode. VCD will display a graphical tree display of the directory structure. Once the display is up, you can use the following keys to move around the display: or - moves highlight up or scrolls screen down or - moves highlight down or scrolls screen up - - - - - - moves the screen up one page - - - - - - moves the screen down one page - - - - - - moves to the root directory "\" - - - - - - - moves to the end of the display - - - - - - ends the program and goes to the highlighted directory. - - Speed searches for directory match. - - - - - - - ends the program without changing directories. - - - Speed search for next directory match. - - - - - - - ReScan the current drive. - - - - - - - Change to a different drive. _____________________________________________________________ REGISTRATION AND LICENSING __________________________ If you find VCD useful, your registration would be appreciated. Registration costs $15. Send registrations to Les J. Ventimiglia 15247 Monroe Ave. Moorpark, CA. 93021 Phone : (805) 529-6370 CompuServ : (CIS) 76307,1246 _____________________________________________________________ SHAREWARE LICENSE _________________ This program is distributed under the SHAREWARE concept. You are encouraged to copy and share this program with other users. SUPPORT SHAREWARE WITH YOUR REGISTRATION FEES!! SHAREWARE is based on these three beliefs: 1. The value of software is best assessed by the user on his own system. 2. Creation of personal computer software can and should be supported by computing community. 3. That copying of programs should be encouraged, rather than restricted. This document and the current version of this program ("the software") are copyrighted by the author. The copyright owner hereby licenses you to: use the software; make as many copies of the program and documentation as you wish; give such copies to anyone; and distribute the software and documentation via electronic means. However, you are specifically prohibited from charging, or requesting donations, for any such copies, however made. No copy of the software may be distributed or given away without this document; and this notice must not be removed. _____________________________________________________________ DISCLAIMER OF WARRANTY ______________________ LES J. VENTIMIGLIA hereby disclaims all warranties relating to this software, whether express or implied, including without limitation any implied warranties of merchantability or fitness for a particular purpose. LES J. VENTIMIGLIA will not be liable for any special, incidental, consequential, indirect or similar damages due to loss of data or any other reason. In no event shall LES J. VENTIMIGLIA's liability for any damages ever exceed the price paid for the license to use the software, regardless of the form of the claim. _____________________________________________________________ VIO/Network/Windows Warnings ____________________________ Through out the testing of this program, I have found that the VIO functions used to display output onto the screen may not work as expected when run in real mode in a Windows windowed DOS session or if your are running the Novell client software on top of real mode DOS. For Windows 3.0, I have found that if I run a VIO'ed program in a windowed DOS session, I tend to get black characters on a black background. This problem goes away as soon as the cursor reaches the bottom of the windowed box. For Novell, I have found that running VIO'ed programs tend to crash the client software if the network card is set to I/O port 2e0h. The solution to this problem it to move the port address of the network card to 300h. This conflict is due to a bug in the VIO libraries supplied with the toolkit.