IBM 2 Computer Hardware User Manual


 
CCA Release 2.54 MAC_Verify
Format
CSNBMVR
return_code Output Integer
reason_code Output Integer
exit_data_length In/Output Integer
exit_data In/Output String exit_data_length bytes
key_identifier Input String 64 bytes
text_length Input Integer
text Input String text_length bytes
rule_array_count Input Integer zero, one, two, or three
rule_array Input String
array
rule_array_count * 8 bytes
chaining_vector In/Output String 18 bytes
MAC Input String 9 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_identifier
The key_identifier parameter is a pointer to a string variable containing an
internal key-token or the key label of an internal key-token record in key
storage. Use either MAC, MACVER, DATA, DATAM, or DATAMV key-types.
Keys can be either single length or double length.
text_length
The text_length parameter is a pointer to an integer variable containing the
number of bytes of data in the text variable.
text
The text parameter is a pointer to a string variable containing the text the
hardware uses to calculate the MAC.
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. The value must be zero,
one, two, or three for this verb.
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:
Keyword Meaning
MAC ciphering-method (one, optional)
EMVMAC Specifies the EMV-related message-padding and calculation
method. You must also specify use of a single-length key.
EMVMACD Specifies the EMV-related message-padding and calculation
method. You must also specify use of a double-length key.
X9.9-1 Specifies the ANSI X9.9-1 and X9.19 Basic Procedure. This
is the default for a single-length key.
X9.19OPT Specifies the ANSI X9.19 Optional Procedure. This is the
default for a double length key.
Chapter 6. Data Confidentiality and Data Integrity 6-15