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 ]