Filter
Top Products
Key_Part_Import CCA Release 2.54
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:
key_part
The key_part parameter is a pointer to a string variable containing a key part to
be entered. The key part may be either 8 or 16 bytes in length. For 8-byte
keys, place the key part in the high-order bytes of the 16-byte key-part field.
The information in this variable must be defined but will be ignored by the
Coprocessor when you use the COMPLETE rule-array keyword.
key_identifier
The key_identifier parameter is a pointer to a string variable containing the
internal DES key-token or a key label for a DES key-token. The key token
must not be null and does supply the control vector for the partial key.
Figure 5-14. Key_Part_Import Rule_Array Keywords
Keyword Meaning
Key part (one required)
FIRST Specifies that an initial key-part is provided. The verb returns
this key-part encrypted by the master key in the key token
which you supplied.
ADD-PART Specifies that additional key-part information is provided. The
verb exclusive-ORs the key part into the key information held
encrypted in the key token.
COMPLETE Specifies that the key-part bit shall be turned off in the control
vector of the key rendering the key fully operational. Note that
no key_part information is added to the key with this keyword.
MIDDLE Specifies that an intermediate key-part, which is neither the
first key-part nor the last key-part, is provided. The verb
exclusive-ORs the key part into the key information held
encrypted in the key token. Note that the command control
point for this keyword is the same as that for the LAST
keyword and different from that for the ADD-PART keyword.
LAST Specifies that the last key-part is provided. The verb
exclusive-ORs the key part into the key information held
encrypted in the key token. The key-part bit is turned off in
the control vector.
5-56 IBM 4758 CCA Basic Services, Release 2.54, February 2005