IBM 2 Computer Hardware User Manual


 
CCA Release 2.54 Control_Vector_Generate
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.
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 the valid combinations of
keywords for the key type and the rule array, see Figure 5-4 on page 5-9. The
rule_array keywords are shown below:
ANY
CLR8-ENC
5
CPINENC
CPINGEN
CPINGENA
DALL
DATA
DDATA
DEXP
DIMP
DKYL0
DKYL1
DKYL2
DKYL3
DKYL4
DKYL5
DKYL6
DKYL7
DMAC
DMKEY
DMPIN
DMV
DOUBLE
DPVR
EPINGEN
EPINGENA
EPINVER
EXEX
EXPORT
GBP-PIN
GBP-PINO
IBM-PIN
IBM-PINO
IMEX
IMIM
IMPORT
INBK-PIN
KEY-PART
KEYLN8
KEYLN16
LMTD-KEK
MIXED
NOOFFSET
NO-SPEC
NO-XPORT
NOT-KEK
OPEX
OPIM
PIN
REFORMAT
SINGLE
SMKEY
6
SMPIN
7
TRANSLAT
UKPT
VISA-PVV
XLATE
XPORT-OK
reserved
This reserved parameter is a pointer to a string variable. The parameter must
either be a null pointer, or a pointer to a variable of eight bytes of X'00'.
control_vector
The control_vector parameter is a pointer to a string variable containing the
control vector returned by the verb.
Required Commands
This verb has no required hardware commands because control vector generation
does not require cryptographic operations. The verb processes the request in the
security API stub.
5
CLR8-ENC must be coded when the KEYGENKY key-type is coded.
6
SMKEY can be coded when the DKYGENKY key-type is coded. (Footnote was incorrect.)
7
SMPIN can be coded when the DKYGENKY key-type is coded. (Footnote was incorrect.)
Chapter 5. DES Key-Management
5-25