For example, the sample user exit program in C that is provided in the SRCLIB library returns the following result set:
char results_set_without_terminators[] =
{
"ADA,DBID=8242,FILENUM=104,ActionFlag=1,ActionValue=12345678;"
"ADA,DBID=8242,FILENUM=105,ActionFlag=1,ActionValue=12345678;"
"ADA,DBID=8262,FILENUM=105,ActionFlag=1,ActionValue=12345678;"
"ADA,DBID=0,FILENUM=0,ActionFlag=1,ActionValue=87654321;"
};
Each statement in the result set contains the following comma-separated fields:
ADA. Required. Identifies the source type to which the user exit program applies. ADA is the only supported value.
DBID=
nnn
. Optional. The database ID of a database that is protected by an Adabas cipher code. If DBID is not specified or is equal to 0, the cipher code applies to all DBIDs.
FILENUM=
nnn
. Optional. The file number of an Adabas file that is protected by an Adabas cipher code. If FILENUM is not specified or is equal to 0, the cipher code applies to all FILENUM numbers.
ActionFlag=
n
. Required. The type of action that the user exit performs. A value of 1 indicates the decryption of data by using an Adabas cipher code.
ActionValue=
cipher_code
. Required. An Adabas cipher code of up to eight numeric digits.
For example, the following statement identifies a cipher code to be used only for the Adabas database with database ID 83:
ADA,DBID=83,ActionFlag=1,ActionValue=12345678
The following statement omits the DBID value to indicate that the cipher code is to be used with all Adabas databases on the z/OS system:
ADA,ActionFlag=1,ActionValue=12345678
In both examples, because no FILENUM value is provided, the cipher code applies to all ciphered Adabas files in the database.