IBM 2 Computer Hardware User Manual


 
CCA Release 2.54 MAC_Generate
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 resulting
MAC returned by the verb. The value is left-justified in the variable. Allocate a
variable large enough to receive the resulting MAC value.
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 presents it as eight
hexadecimal characters.
HEX-9 Specifies a four-byte MAC and presents it as two groups of
four hexadecimal characters separated by a space character.
Required Commands
The MAC_Generate verb requires the Generate MAC command (offset X'0010') to
be enabled in the hardware.
Chapter 6. Data Confidentiality and Data Integrity 6-13