Control_Vector_Generate CCA Release 2.54
Control_Vector_Generate (CSNBCVG)
Platform/
Product
OS/2 AIX Win NT/
2000
OS/400
IBM 4758-2/23 X X X X
The Control_Vector_Generate verb builds a control vector from keywords specified
by the key_type and rule_array parameters. For descriptions of the keywords and
for valid combinations of these keywords, see Figure 5-4 on page 5-9, “Key Types”
on page 5-5, and “Key-Usage Restrictions” on page 5-6. You may achieve added
security by using optional keywords, or in some cases required keywords, supplied
in the rule-array variable.
Restrictions
None
Format
CSNBCVG
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length bytes
key_type Input String 8 bytes
rule_array_count Input Integer
rule_array Input String
array
rule_array_count * 8 bytes
reserved Input String null pointer or XL8'00'
variable
control_vector Output String 16 bytes
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_type
The key_type parameter is a pointer to a string variable containing a keyword
for the key type. The keyword is eight bytes in length, left-justified and padded
on the right with space characters. Supply a keyword from the following list:
CIPHER
CVARDEC
CVARENC
CVARPINE
CVARXCVL
CVARXCVR
DATA
DATAC
DATAM
DATAMV
DECIPHER
DKYGENKY
ENCIPHER
EXPORTER
IKEYXLAT
IMPORTER
IPINENC
MAC
MACVER
OKEYXLAT
OPINENC
PINGEN
PINVER
KEYGENKY3
SECMSG4
For definitions of these keywords, see “Control Vectors” on page 5-4.
3CLR8-ENC must be coded in the rule array when the KEYGENKY key-type is coded.
4SMKEY or SMPIN must be coded in the rule array when the SECMSG key-type is coded.
5-24 IBM 4758 CCA Basic Services, Release 2.54, February 2005