Filter
Top Products
Key_Token_Build 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.
key_token
The key_token parameter is a pointer to a string variable containing the
assembled key-token.
Note: This variable cannot contain a key label.
key_type
The key_type parameter is a pointer to a string variable containing a keyword
that defines 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
IMPORTER
IPINENC
KEYGENKY
MAC
MACVER
OKEYXLAT
OPINENC
PINGEN
PINVER
SECMSG
USE-CV
For information about key types, see Appendix C, “CCA Control-Vector
Definitions and Key Encryption” on page C-1.
Specify the USE-CV keyword to indicate the key type should be obtained from
the control vector variable.
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. The rule_array keywords are
shown below:
Figure 5-15 (Page 1 of 2). Key_Token_Build Rule_Array Keywords
Keyword Meaning
Token type (one required)
INTERNAL Specifies an internal key-token.
EXTERNAL Specifies an external key-token.
Key status (one, optional)
KEY Indicates the key token is to contain a key. The key_value
variable contains the key.
NO-KEY Indicates the key token is not to contain a key. This is the
default key status.
5-62 IBM 4758 CCA Basic Services, Release 2.54, February 2005