This service provider interface enables the possibility to write custom functions for managing the data key for FLAMFILEs. It can be used to support different kind of cryptographic infrastructures.

Interface standards

The service provider interface is build on one function with 10 parameters as classic load module interface. All parameters for the main function are call-by-reference and the function itself don't have a return value. The return code is the second parameter of the function. There are only 2 types of parameters:

POINTER:   pointer to an address (usually 32 (PIC S9(9) COMP) or 64 bit)
INTEGER:   pointer to a 32 bit number in two's complement (PIC S9(9) COMP)

The type INTEGER has local endianness. On mainframes, this is usually big endian. This means that the most significant byte is stored first (i.e. at the lowest memory address) and the least significant byte is stored last. On x86 platforms, the byte order is little endian. This means that the byte order is reversed.

The pointer type is used for certain byte arrays.