IBM 2 Computer Hardware User Manual


 
Random_Number_Tests CCA Release 2.54
Random_Number_Tests (CSUARNT)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X
The Random_Number_Tests verb invokes the USA NIST FIPS PUB 140-1
specified cryptographic operational tests. These tests, selected by a rule-array
keyword, consist of:
For random numbers: monobit test, poker test, runs test, and long run test
Known answer tests of DES, RSA, and SHA-1 processes.
The tests are performed three times. If there is any test failure, the verb returns
return code four and reason code one.
Restrictions
None
Format
CSUARNT
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length bytes
rule_array_count Input Integer one
rule_array Input String
array
rule_array_count * 8 bytes
Parameters
For the definitions of the return_code, reason_code, exit_data_length, and exit_data
parameters, see “Parameters Common to All Verbs” on page 1-11.
rule_array_count
The rule_array_count parameter is a pointer to an integer variable containing
the number of elements in the rule_array variable. The value must be one for
this verb.
rule_array
The rule_array parameter is a pointer to a string variable containing an array of
keywords. The keywords are eight bytes in length, and must be left-justified
and padded on the right with space characters. The rule_array keywords are
shown below:
Keyword Meaning
Test selection (one required)
FIPS-RNT Perform the FIPS 140-1 specified test on the random number
generation output.
KAT Perform the FIPS 140-1 specified known-answer tests on
DES, RSA, and SHA-1.
2-64 IBM 4758 CCA Basic Services, Release 2.54, February 2005