## Storage Device Driver Reference

[prev][next][parent][TOC]

### Description of Test Cases

Each of the DASD test cases can be executed by invoking the DDTT from either a command line, a batch file, or a REXX file. Test scripts are described below. The user is free to create additional tests or construct multi-threaded test cases after becoming familiar with the DDTT and the DASD grammar files.

Test scripts generally start by opening to the physical or logical disk and closing at completion. File operations do not require Open or Close operations as they do this internally. All test scripts log information to a log file of the same file name, but with a file name extension of .LOG. When lock status or device parameters are queried, the data is written to the DDTT's scroll output window and to the log file. Log files can be examined with a text editor after the test case has completed.

Disk sectors are addressed by cylinder, head, and sector. The maximum values for these parameters can be found with either GET_LOGICAL_PARAMS or GET_PHYSICAL_PARAMS.

DASDSTD1.SCR This script exercises all DASD physical API commands. It should be directed to a fixed disk not currently booted.

DASDSTD2.SCR This script exercises all DASD logical API commands. It should be directed to a logical drive on a fixed disk, preferably not the boot partition.

DASDERR1.SCR This script exercises the device driver's ability to detect errors related to invalid data and invalid command sequences for a physical disk. It requires a fixed disk target.

DASDERR2.SCR This script exercises the device driver's ability to detect errors related to invalid data and invalid command sequences for a logical disk. It requires a fixed disk target.

FLOPSTD.SCR This script exercises all DASD logical API commands for a removable media device. It should be directed to a floppy drive. This test script should be copied to the floppy media where it will serve as the test file.

FLOPFILE.SCR This script exercises file-oriented API commands for a removable media device. It should be directed to a floppy drive. This test script should be copied to the floppy media where it will serve as the test file.

FLOPERR.SCR This script exercises the device driver's ability to detect errors related to invalid handle and device-not-ready conditions. It requires a removable media target drive.

FLOPERR2.SCR This script exercises the device driver's ability to detect errors related to invalid data conditions. It requires a removable media target drive.

FLOPZIP.SCR This script exercises all DASD logical API commands for a removable media device. It should be directed to drives that use media larger than a standard floppy diskette.