IBM TS2340 User Guide - Page 435

Windows - Utility Program (ntutil) eight characters or less. Ntutil adds the .dmp extension automatically. The dump is written into the directory where ntutil was started. read_write (test): SYNTAX: read_write for example, read_write FUNCTION Tested: This command performs the following test on the cartridge in the tape device special file opened previously: 1. Rewind the tape. 2. Set Media Parameters to fixed block 32K. 3. Write a 32K random data block on tape. 4. Rewind the tape. 5. Read the block and compare the data to the data written in step 3. restore_data: SYNTAX: restore_data restore_data file_name=string for example, read_data file_name=fsc0000 FUNCTION Tested: This command calls the device driver ReadFile entry point. It attempts to perform 64 KB variable block read operations on the tape device special file until either a filemark or an end of data is detected. All the data read, regardless of error, is saved in the file specified. If there is no data on the tape, the command fails, and no data is saved. The RC should be ignored in most cases, because this operation always ends with an error (either filemark detected or end of data detected). return_error: SYNTAX: return_error_state for example, return_error_state FUNCTION Tested: This command calls GetLastError. If the command is successful, the information returned is displayed. There is no RC for this function. return_lib_inventory_all: SYNTAX : return_lib_inventory_all for example, return_lib_inventory_all FUNCTION Tested: This command calls the device driver DeviceIoControl entry point with an opcode of LIBRARY_INVENTORY. It attempts to return information about all the hardware components in a library. If this command is successful, the information returned is displayed. For Windows NT, refer to the appropriate hardware manuals for a description of the information returned by a read element status command. Appendix D. Tape Utility Programs 417