IBM 2 Computer Hardware User Manual


 
Decipher CCA Release 2.54
ciphertext
The ciphertext parameter is a pointer to a string variable containing the text to
be deciphered.
initialization_vector
The initialization_vector parameter is a pointer to a string variable containing
the initialization_vector the verb uses with the input data.
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. This value must be zero,
one, two, or three 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.
For an adapter that supports both DES and CDMF, you can choose the
encryption process.
The rule_array keywords are shown below:
chaining_vector
The chaining_vector parameter is a pointer to a string variable containing the
segmented data between calls by the security server. The output chaining
vector is contained in bytes zero through seven.
Note: The application program must not change the data in this variable.
plaintext
The plaintext parameter is a pointer to a string variable containing the plaintext
returned by the verb. The starting address of plaintext variable cannot begin
within the ciphertext variable. The verb updates the text_length variable to the
Keyword Meaning
Deciphering method (one, optional)
CBC Specifies cipher-block chaining. The data must be a multiple
of eight bytes. This is the default.
X9.23 Specifies cipher-block chaining with one to eight bytes of
padding. This is compatible with the requirements in ANSI
Standard X9.23.
ICV (one, optional)
INITIAL Specifies use of the initialization vector from the key token or
the initialization vector to which the initialization_vector
parameter points. This is the default.
CONTINUE Specifies use of the initialization vector to which the
chaining_vector parameter points. The CONTINUE keyword
is not valid with with the X9.23 keyword.
Decryption process (one, optional)
DES Specifies use of the DES ciphering algorithm. If an adapter
does not support DES general data-decipherment, the verb is
rejected. This is the default on an adapter that supports both
DES and CDMF.
CDMF Specifies use of the CDMF ciphering algorithm.
6-6 IBM 4758 CCA Basic Services, Release 2.54, February 2005