IBM 2 Computer Hardware User Manual


 
CCA Release 2.54 Control_Vector_Translate
mask_array_left
The mask_array_left parameter is a pointer to a string variable containing the
mask array enciphered under the left-array key.
array_key_right
The array_key_right parameter is a pointer to a string variable containing an
internal key-token or the key label of an internal key-token record that
deciphers the right mask-array. The internal key-token must contain a control
vector specifying a CVARXCVR key-type.
mask_array_right
The mask_array_right parameter is a pointer to a string variable containing the
mask array enciphered under the right-array key.
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, or two 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:
Figure 5-10. Control_Vector_Translate Rule_Array Keywords
Keyword Meaning
Parity adjustment (one, optional)
ADJUST Ensures that all target-key bytes have odd parity. This is the
default.
NOADJUST Prevents the parity of the target key from being altered.
Key portion (one, optional)
LEFT Causes an 8-byte source key, or the left half of a 16-byte
source key, to be processed with the result placed into both
halves of the target key. This is the default.
RIGHT Causes the right half of a 16-byte source key to be processed
with the result placed into only the right half of the target key.
The left half of the target key is unchanged.
BOTH Causes both halves of a 16-byte source key to be processed
with the result placed into corresponding halves of the target
key. When you use the BOTH keyword, the mask array must
be able to validate the translation of both halves.
SINGLE Causes the left half of the source key to be processed with
the result placed into only the left half of the target. The right
half of the target key is unchanged.
Chapter 5. DES Key-Management 5-27