Generate Clustered Hash Table Key (QcstGenerateCHTKey) API

Required Parameter Group:

1	Key	Output	Char(*)
3	Length of key to generate	Input	Binary(4)
2	Connection handle	Input	Char(16)
4	Error Code	I/O	Void(*)

  Service Program: QCSTCHT

  Default Public Authority: *USE

  Threadsafe: Yes

The Generate Clustered Hash Table Key (QcstGenerateCHTKey) API returns a universally unique key that can be used to store an entry into the clustered hash table.

Restrictions:

A connection must have been established with the clustered hash table server.
When this API is called, the clustered hash table server must be active on the requesting node.
This API must be run under the same job that issued the Connect Clustered Hash Table (QcstConnectCHT) API.

Authorities and Locks

Required Parameter Group

Key: OUTPUT; CHAR(*)
The receiver variable that receives the generated key. The size of this parameter must be at least equal to the length of key to generate parameter.
Length of key to generate: INPUT; BINARY(4)
The length of the key to be generated. This length must be equal to 16.
Connection handle: INPUT; CHAR(16)
This is an active connection handle for the clustered hash table server. It is obtained by calling the Connect Clustered Hash Table (QcstConnectCHT) API.
Error code: I/O; CHAR(*)
The structure in which to return error information. For the format of the structure, see Error code parameter.

Error Messages

Message ID	Error Message Text
CPF3C1D E	Length specified in parameter &1 not valid.
CPF3C19 E	Error occured with receiver variable specified.
CPF3C1E E	Required parameter &1 omitted.
CPF3C3C E	Value for parameter &1 not valid.
CPF3CF1 E	Error code parameter not valid.
CPF3CF2 E	Error(s) occurred during running of &1 API.
CPFBB26 E	Cluster Resource Services not active or not responding.
CPFBD09 E	Clustered hash table server &1 not active or not responding.
CPFBD0B E	Connection handle not active.

API introduced: V5R2

[ Back to top | Cluster APIs | APIs by category ]