IBM TS2340 User Guide - Page 439
Supported Result Text Fields, write_filemark, return_error_when_fail
UPC - 883436006873
View all IBM TS2340 manuals
Add to My Manuals
Save this manual to your list of manuals |
Page 439 highlights
Windows - Utility Program (ntutil) write_filemark: SYNTAX: write_filemark n for example, write_filemark 2 (write 2 file marks) FUNCTION Tested: This command calls the device driver WriteTapemark entry point with an operation of TAPE_FILEMARKS and a count of n. It attempts to write n filemarks on the tape media. Supported Result Text Fields The result text on a command statement is used to test completion status for an expected result. Further execution of a test case is affected by the current settings of the return_error_when_fail and exit_on_unexpected_result variables. These can be set using a set statement. If no result text is specified, the command is treated as successful. In the case of rc, except as noted in the command section, a failure returns -1. Otherwise, the operation succeeded. The syntax for result text is: < rc < n> > > > = == == == != != != where: rc = return code from the last command. err = Operating System GetLastError () value for the last command. data = expected record identifier for a read command. For example, consider this statement in the input file: command write 1 result rc == -1 err == WRITE_PROTECT This means we will try to write one record to tape and we expect this to fail with return code -1, err WRITE_PROTECT. Note: Symbolic values or integers can be used for err. See the appendix on symbolic values for a list of those recognized. set: This statement allows setting of variables that affect how tests are executed. The syntax for a set statement is: set variable = value for example, set return_error_when_fail = 1 Here are the variables that can be set: return_error_when_fail Can be set to 1 (true) or 0 (false). A setting of true means ntutil ends by returning an error at the end of the test if any command does not produce a correct expected result as specified in result text. Appendix D. Tape Utility Programs 421