SAMPLE: Fp0779.exe ISDISKIN Utility

Last reviewed: February 11, 1998
Article ID: Q96480
1.02 2.00 2.50 2.50a 2.50b 2.60 MS-DOS kbprg kbappnote kbfile kbcode

The information in this article applies to:

  • Microsoft FoxPro for MS-DOS, versions 1.02, 2.0, 2.5, 2.5a, 2.5b, 2.6

SUMMARY

Fp0779.exe is a sample that contains the ISDISKIN utility that provides an alternative method of dealing with the "Not Ready Reading Drive A" error message.

MORE INFORMATION

The following file is available for download from the Microsoft Software Library:

~ Fp0779.exe

For more information about downloading files from the Microsoft Software Library, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q119591
   TITLE     : How to Obtain Microsoft Support Files from Online Services

When a FoxPro program attempts to load a file from a floppy disk and no disk is present in the drive or the drive door is open, MS-DOS returns a "Not ready reading drive <letter>" message and provides the option to "Abort, Retry, Ignore" the error.

To provide an alternative method of dealing with this error, the ISDISKIN utility is included in the multiuser version of Microsoft FoxPro versions 1.02 and 2.0 for MS-DOS. A FoxPro application can call ISDISKIN to determine the status of the drive and, if necessary, provide a more appropriate message for the user.

THE TEXT OF FP0779

       Microsoft(R) Technical Support Application Note (Text File)
                       FP0779: ISDISKIN UTILITY
                                                   Revision Date: 2/94
                                                       1 Disk Included

The following information applies to Microsoft FoxPro(R) versions 1.02, 2.0, 2.5, 2.5a, and 2.5b for MS-DOS(R).

| INFORMATION PROVIDED IN THIS DOCUMENT AND ANY SOFTWARE THAT MAY     |
| ACCOMPANY THIS DOCUMENT (collectively referred to as an Application |
| Note) IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER      |
| EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED      |
| WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR       |
| PURPOSE. The user assumes the entire risk as to the accuracy and    |
| the use of this Application Note. This Application Note may be      |
| copied and distributed subject to the following conditions:  1) All |
| text must be copied without modification and all pages must be      |
| included;  2) If software is included, all files on the disk(s)     |
| must be copied without modification (the MS-DOS utility diskcopy is |
| appropriate for this purpose);  3) All components of this           |
| Application Note must be distributed together;  and  4) This        |
| Application Note may not be distributed for profit.                 |
|                                                                     |
| Copyright (C) 1993-1994 Microsoft Corporation. All Rights Reserved. |
| Microsoft, FoxPro, and MS-DOS are registered trademarks and Windows |
| is a trademark of Microsoft Corporation.                            |
|---------------------------------------------------------------------|

INTRODUCTION

When a FoxPro program attempts to load a file from a floppy disk and no disk is present in the drive or the drive door is open, MS-DOS returns a "Not ready reading drive <letter>" message and provides the option to "Abort, Retry, Ignore" the error. The ISDISKIN utility on the disk enclosed with this Application Note is a binary file that provides an alternative method of dealing with this situation. A FoxPro application can call ISDISKIN to determine the status of the drive and, if necessary, provide a more appropriate message for the user.

NOTE: .BIN routines cannot be used in the Windows environment.

To install ISDISKIN

NOTE: If you are using the multiuser version of FoxPro 1.02 or 2.0, ISDISKIN.BIN is already installed in the FOXPRO2\GOODIES\ADDUSER directory by default.

  1. Insert the enclosed FP0779 disk in your floppy disk drive.

  2. Copy Isdiskin.bin to your main FoxPro directory. To do this, type the following at the MS-DOS command prompt and press ENTER

          copy <drive>:\isdiskin.bin <destination>
    

    where <drive> is the floppy disk drive containing the FP0779 disk and <destination> is the drive and directory where your FoxPro files are located.

    For example, if the FP0779 disk is in drive A, and your FoxPro directory is named FOXPRO25 and is on drive C, type the following command:

          copy a:\isdiskin.bin c:\foxpro25
    

To use ISDISKIN in a FoxPro program

  1. If you are using FoxPro version 2.5 or later or the single-user version of FoxPro version 1.02 or 2.0, issue this command:

          SET DEFAULT TO <FoxPro directory>
    

    If you are using the multiuser version of FoxPro version 1.02 or 2.0, issue this command:

          SET DEFAULT TO C:\FOXPRO2\GOODIES\ADDUSER
    

  2. Use the LOAD command to load the Isdiskin.bin file.

  3. Create a character memory variable. Set the variable to the drive letter for the disk drive to test. For example, create a memory variable called <pvalue> and set it equal to "A:".

  4. Use the CALL command to invoke the Isdiskin.bin file with the character memory variable as a parameter.

ISDISKIN returns one of the following values to indicate the status of the disk drive:

   Return value     Meaning
   ----------------------------------------------------------------------

   A:               Drive A tested and a disk is present in drive A.
   B:               Drive B tested and a disk is present in drive B.
   0: (zero)        No disk is present in the tested drive.

NOTE: Isdiskin.bin must be loaded each time the drive requires testing. If multiple calls are made without reloading and the return value has changed from A: to 0:, reinserting a disk will not cause A: to be returned; the return value will remain 0:. To use the function reliably, reload it before every call.

SAMPLE PROGRAM

   * If you are using the multiuser version of FoxPro 1.02 or 2.0, use
   * SET DEFAULT TO C:\FOXPRO2\GOODIES\ADDUSER instead of the
   * following line.
   SET DEFAULT TO <FoxPro directory>
   LOAD isdiskin.bin
   pvalue = "A:"
   CALL isdiskin.bin WITH pvalue
   DO CASE
   CASE pvalue = "A:"
      RUN DIR A:
   CASE pvalue = "0:"
      WAIT WINDOW "Please put a disk into drive A:"
   ENDCASE


Additional reference words: FoxDos 1.02 2.00 2.50 2.50a 2.50b 2.60 AppNote
FP0779
softlib
KBCategory: kbprg kbappnote kbfile kbcode
KBSubcategory:
Keywords : FxtoolGeneral kbappnote kbcode kbfile kbprg
Version : MS-DOS:1.02,2.0,2.5,2.5a,2.5b,2.6
Platform : MS-DOS
Issue type : kbfile


THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: February 11, 1998
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.