IBM 2 Computer Hardware User Manual


 
MAC_Verify CCA Release 2.54
chaining_vector
The chaining_vector parameter is a pointer to a string variable containing a
work area the security server uses to carry segmented data between
procedure-calls.
Note: The application program must not change the data in this variable.
MAC
The MAC parameter is a pointer to a string variable containing the trial MAC.
Ensure that this parameter is a pointer to a nine-byte string variable, because
nine bytes are always sent to the security server. The MAC value must be
left-justified in the variable. The verb verifies the MAC if you specify the ONLY
or LAST keyword for the segmenting control.
Keyword Meaning
Segmenting control (one, optional)
ONLY Specifies the application program does not use segmenting.
This is the default.
FIRST Specifies this is the first segment of data from the application
program.
MIDDLE Specifies this is an intermediate segment of data from the
application program.
LAST Specifies this is the last segment of data from the application
program.
MAC length and presentation (one, optional)
MACLEN4 Specifies a four-byte MAC. This is the default.
MACLEN6 Specifies a six-byte MAC.
MACLEN8 Specifies an eight-byte MAC.
HEX-8 Specifies a four-byte MAC and accepts it as eight
hexadecimal characters.
HEX-9 Specifies a four-byte MAC and accepts it as two groups of
four hexadecimal characters separated by a space character.
Required Commands
The MAC_Verify verb requires the Verify MAC command (offset X'0011') to be
enabled in the hardware.
6-16 IBM 4758 CCA Basic Services, Release 2.54, February 2005