Filter
Top Products
CCA Release 2.54 Key_Token_Parse
Note: You cannot use a key label for a key-token record in key storage. The
key token must be in application storage.
key_type
The key_type parameter is a pointer to a string variable containing a keyword
defining the key type. The keyword is eight bytes in length, and must be
left-justified and padded on the right with space characters. Valid key_type
keywords are shown below:
CIPHER
CVARDEC
CVARENC
CVARPINE
CVARXCVL
CVARXCVR
DATA
DATAC
DATAM
DATAMV
DECIPHER
DKYGENKY
ENCIPHER
EXPORTER
IKEYXLAT
KEYGENKY
IMPORTER
IPINENC
MAC
MACVER
OKEYXLAT
OPINENC
PINGEN
PINVER
SECMSG
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. This value must be a
minimum of 3 and should be at least 20 for this verb.
On input, specify the maximum number of usable array elements that are
allocated. On output, the verb sets the value to the number of keywords
returned to the application.
rule_array
The rule_array parameter is a pointer to a string variable containing an array of
keywords that expresses the contents of the key token. The keywords are
eight bytes in length, and are left-justified and padded on the right with space
characters. The rule_array keywords are shown below:
Figure 5-17. Key_Token_Parse Rule_Array Keywords
Keyword Meaning
Token type (one returned)
INTERNAL Specifies an internal key-token.
EXTERNAL Specifies an external key-token.
Key status (one returned)
KEY Indicates the key token contains a key. The key_value
variable contains the key.
NO-KEY Indicates the key token does not contain a key.
Control-vector (CV) status (one returned)
CV The key token specifies that a control vector is present. The
verb sets the control vector variable with the value of the
control vector found in the key token.
NO-CV The key token does not specify the presence of a control
vector. The verb sets the control vector variable with the
value of the control vector field found in the key token.
Control-vector keywords
See Figure 5-4 on page 5-9 for the key-usage keywords that
can result with a given key type.
Chapter 5. DES Key-Management 5-67