IBM 2 Computer Hardware User Manual


 
CCA Release 2.54 Cryptographic_Variable_Encipher
Cryptographic_Variable_Encipher (CSNBCVE)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The Cryptographic_Variable_Encipher verb uses a CVARENC key to encrypt
plaintext to produce ciphertext using the Cipher Block Chaining (CBC) method.
The plaintext must be a multiple of eight bytes in length.
Specify the following to encrypt plaintext:
An internal key-token or a key label of an internal key-token record that
contains the key to be used to encrypt the plaintext with the
c-variable_encrypting_key_identifier parameter. The control vector in the key
token must specify the CVARENC key-type.
The length of the plaintext, which is the same as the length of the returned
ciphertext, with the text_length parameter. The plaintext must be a multiple of
eight bytes in length.
The plaintext with the plaintext parameter.
The initialization vector with the initialization_vector parameter.
A field for the returned ciphertext with the ciphertext parameter. The length of
this field is the length that you specified with the text_length parameter.
The verb does the following:
Uses the CVARENC key and the initialization value with the CBC method to
encrypt the plaintext.
Returns the encrypted plaintext in the variable pointed to by the ciphertext
parameter.
Restrictions
The text length must be a multiple of eight bytes.
The minimum length of text that the security server can process is 8 bytes and
the maximum is 256 bytes.
Format
CSNBCVE
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length bytes
c-variable_encrypting_key_identifier Input String 64 bytes
text_length Input Integer
plaintext Input String text_length bytes
initialization_vector Input String 8 bytes
ciphertext Output String text_length bytes
Chapter 5. DES Key-Management 5-29