IBM 2 Computer Hardware User Manual


 
CCA Release 2.54 Encipher
text_length
The text_length parameter is a pointer to an integer variable. On input, the
text_length variable contains the number of bytes of data in the cleartext
variable. On output, the text_length variable contains the number of bytes of
data in the ciphertext variable.
plaintext
The plaintext parameter is a pointer to a string variable containing the text to be
enciphered.
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. The 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. The rule_array keywords are
shown below:
pad_character
The pad_character parameter is a pointer to an integer variable containing a
value used as a padding character. The value must be in the range from 0 to
255. When you use the X9.23 ciphering method, the security server extends
the plaintext with a count byte and padding bytes as required.
Keyword Meaning
Ciphering 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 the X9.23 keyword.
Encryption process (one, optional)
DES Specifies use of the DES ciphering algorithm. If an adapter
does not support DES general data encipherment, 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.
Chapter 6. Data Confidentiality and Data Integrity 6-9