SSA-NAME3 API Reference Guide

Back Next

ssan3_get_keys

Used to get the SSA-NAME3 Keys for a name or address which the application program will store in the SSA-NAME3 Key table.

This function has been replaced by

ssan3_get_keys_encoded

In	Socket Handle	Refer to the Common Parameters section
In/Out	Session ID	Refer to the Common Parameters section
In	System	Refer to the Common Parameters section
In	Population	Refer to the Common Parameters section
In	Controls	Refer to the Controls section
Out	Response Code	Refer to the Common Parameters section
Out	Error Message	Refer to the SSA-NAME3 Error Messages section
In	Key Field Data	Refer to the Common Parameters section
Out	Keys Count	A number defining the actual number of keys returned for this name or address
Out	Required Keys	An array of 8 or 5-byte keys, depending on the setting of the KEY_SIZE Control, returned for this name or address

For z/OS COBOL this function is named

GETKEYS

When using

KEY_SIZE=5

, you will still allocate space for 8 byte keys, however the last 3 bytes of each key is unused.

Required Keys:

ssan3_get_keys

will return a maximum of 1024 keys. The

MAX_ENTRIES

Control can be used to specify a lower maximum value.

Key Size: 8 byte keys must be used in an application environment that uses the SSA-NAME3 server.