## Storage Device Driver Reference

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

### Script Utility Functions

Test-case script functions are device-specific or generic. Generic or utility-script functions are part of all DDTT grammar files. Most DDTT commands are associated with an aliasname. The general form of a DDTT command is as follows:

       alias_name FUNCTION_NAME [[PARAMETER=value], ...]

The DDTT built-in functions which are not associated with an aliasname are preceded with an "at"(@) character.

Script Utility Function keywords and their parameters are case insensitive and all tokens are uppercased by the DDTT. In the descriptions below, upper case represents fixed tokens or keywords, and lower case indicates a variable token, specific to the particular function invokation. To preserve a token's case, use the syntax $(Token).

All DDTT commands are automatically continued to the next line if the last character in the line is the backslash character (\).

The DDTT test case files can use OS/2 environment variables. Environment variables can be used anywhere in the script. Any valid symbolic token with a (%) sign preceding it will be interpreted as an OS/2 system environment variable. To establish or change an environment variable from an OS/2 prompt, type the following:

       [C:\]set cdrom=cdrom.scr.

The environment variable can then be referenced from within a test case script as follows:

       @thread %cdrom.

(%cdrom will then be replaced by cdrom.scr.)