Each of the CD-ROM 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 CD-ROM grammar
files.
Test scripts generally start by opening to the device (CDROM_OPEN) and closing
at completion (CDROM_CLOSE). The device open will not succeed unless a
disc is present. All test scripts log information to a log file of the
same file name, but with a file name extension of .LOG. When current status
is queried (for example, track, channel, or drive), this 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.
The CD-ROM Play-Audio function causes the CD-ROM drive to play the audio
media by sending the audio signal to the CD-ROM's own pre-amplified outputs.
The audio is not played through the system speaker or any multi-media device.
CD-ROM discs are accessed by Logical Block or Redbook format. Logical block
format sequentially addresses each block on the disc starting at 0. Redbook
format addresses each block using a time format of MM:SS:FF (MM represents
minutes from the start of the CD, SS represents seconds, and FF represents
frames.) Each frame represents 1/75th of a second. Logical block 0 and
Redbook format block 0:2:0 are coincident and both represent the first addressable
block.
XADATA.SCR
This script exercises all CD-ROM data
API interfaces. It requires the IBM Test Disc (IBM part number 81F8902)
which contains known data, known size parameters, and tracks containing
mode 1 and mode 2 data.
XAAUDIO.SCR
This script
exercises all CD-ROM audio API interfaces. It requires the IBM Test Disc
and a pair of speakers or headphones plugged into the CD drive audio jack.
The test disc has 3 audio tracks containing tones. Track 2 has different
tones on left and right channels.
XAERROR.SCR
This script
exercises the device driver's ability to detect errors related to invalid
data, missing media, and invalid command sequences. It requires the IBM
Test Disc.
CDFILE.SCR
This script exercises
the device driver's ability to locate and read a file. It requires any
data disk with a directory structure and a data file less than 150KB. The
DDTT for this script is initiated by batch file CDFILE.CMD. The batch file
first calls a filter program to search for a test file candidate. The name
of this target file is passed to the DDTT test script as an included data
file. Invoke by entering CDFILE followed by the CD-ROM drive letter and
a colon.
CDDATA.SCR
This script exercises
all CD-ROM data API interfaces. It requires any data CD-ROM with a directory
structure. Since it is dealing with unknown data, the script is not as
comprehensive as that for XADATA.SCR.
CDAUDIO.SCR
This script
exercises all CD=ROM audio API interfaces. It requires any digital audio
(music) CD-ROM. Since it operates on unknown audio tracks, the script is
not as comprehensive as that for XAAUDIO.SCR.
[Back: Logged Data]
[Next: Evaluation of Test Case Results]