SASIOTEST Command

Writes and reads files that are similar to SAS files in order to measure file I/O throughput on Windows.

Requirements: When you use the -sgio option, -pagesize must be a multiple of 4K on x86 systems and a multiple of 8K on x64 and IPF systems.
If the -sgio option is present, then -numpages is required.
The filename argument must be the first argument.

Syntax

SASIOTEST filename <options>

Required Argument

filename

specifies the filename that is read or written and can include the file system path.

Optional Argument

<options>

-w or -r

-w creates and writes the specified file.

-r reads the specified file.
Default -w

-seq or -ran

-seq reads sequentially from the specified file.

-ran reads randomly from the specified file.
Default -seq

-filesize n

specifies the size of the file to write or read. For example, n can be 800K, 512K, 5MB, 2GB.

Default If -filesize is not specified, the default is 1MB.

-pagesize <n>

specifies the size of the page for the I/O operation. For example, n can be 8K, 64K, 128K.

Default If -pagesize is not specified, the default is 8K.

-sgio

specifies whether Scatter Gather (SGIO) Read and SGIO Write APIs are used for I/O operations. The following options are specific to SGIO:

-numpages <n>

specifies the number of pages to read or write for each SGIO operation.

-unbuffered

specifies that the written pages bypass the file cache.

-writethru

specifies to write through any intermediate cache and go directly to disk.

Examples

Example 1

c:\m904_win>sasiotest test.out -w
SAS I/O Test Utility: v1.0
WARNING: Filesize option not specified. Defaulting to 1 MB filesize.
WARNING: Pagesize option not specified. Defaulting to 8K pagesize.
Sequentially writing 1048576 bytes to file: test.out with a 8192 pagesize.
Write Throughput: 71.100308 MB/Sec.

Example 2

c:\m904_win>sasiotest test.out -w -pagesize 64k
SAS I/O Test Utility: v1.0
WARNING: Filesize option not specified. Defaulting to 1 MB filesize.
Sequentially writing 1048576 bytes to file: test.out with a 65536 pagesize.
Write Throughput: 72.561777 MB/Sec.

Example 3

c:\m904_win>sasiotest test.out -w -pagesize 4k -filesize 2M
SAS I/O Test Utility: v1.0
Sequentially writing 2097152 bytes to file: test.out with a 4096 pagesize.
Write Throughput: 45.795315 MB/Sec.

Example 4

c:\m904_win>sasiotest test.out -r
SAS I/O Test Utility: v1.0
WARNING: Filesize option not specified. Defaulting to 1 MB filesize.
WARNING: Pagesize option not specified. Defaulting to 8K pagesize.
Sequentially reading 1048576 bytes from file: test.out with a 8192 pagesize.
Read Throughput: 258.301703 MB/Sec.
Note: Even though you are reading the file you just wrote, if you do not specify a PAGESIZE and FILESIZE argument, the sasiotest utility uses its default values of 8K and 1MB. See Example 5 for the correct way to read the file that was created in Example 3.

Example 5

c:\m904_win>sasiotest test.out -r -pagesize 4k -filesize 2M -numpages 2
SAS I/O Test Utility: v1.0
Sequentially reading 2097152 bytes from file: test.out with a 4096 pagesize.
Read Throughput: 237.732948 MB/Sec.

Example 6

c:\m904_win>sasiotest test.out -w -sgio -pagesize 4k -filesize 2G -numpages 256
SAS I/O Test Utility: v1.0
Gather Writing 256 pages - 2 iterations to file: test.out with a 4096 pagesize.
Write Throughput: 18.363657 MB/Sec.

Example 7

c:\m904_win>sasiotest test.out -r -sgio -pagesize 4k -filesize 2G -numpages 256
SAS I/O Test Utility: v1.0
Scatter Reading 256 pages - 2 iterations from file: test.out with a 4096 pagesize.
Read Throughput: 33.205119 MB/Sec.