Filter
Top Products
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
KEYGENKY
3
SECMSG
4
For definitions of these keywords, see “Control Vectors” on page 5-4.
3
CLR8-ENC must be coded in the rule array when the KEYGENKY key-type is coded.
4
SMKEY 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