Connect Clustered Hash Table (QcstConnectCHT) API
Required Parameter Group:
| 1 | Connection handle | Output | Char(16) |
| 2 | Clustered hash table server name | Input | Char(10) |
| 3 | Error code | I/O | Void(*) |
Service Program: QCSTCHT
Default Public Authority: *USE
Threadsafe: Yes
The Connect Clustered Hash Table (QcstConnectCHT) API establishes a connection to the clustered hash table server specified. This API returns a connection handle that will be used on all requests to specified clustered hash table server.
It is recommended to disconnect using the Disconnect Clustered Hash Table (QcstDisconnectCHT) API when the connection is no longer needed.
Restrictions:
- When this API is called, the clustered hash table server must be active on the requesting node.
- Authority to the specified clustered hash table server is controlled by the authorization list specified on the Start Clustered Hash Table Server (STRCHTSVR) command. If no authorization list was specified then any user is allowed to connect to the specified server. If an authorization list was specified *USE authority is needed to connect to the specified server.
- All other clustered hash table APIs must be run under the same job that issues this API.
Authorities and Locks
- Authority to clustered hash table server (if authorization list specified)
- *USE
Required Parameter Group
- Connection handle
- OUTPUT; CHAR(16)
The connection handle to use on all requests into the specified clustered hash table server.
- Clustered hash table server name
- INPUT; CHAR(10)
The name of the clustered hash table server to connect to.
- 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 |
|---|---|
| CPF24B4 E | Severe error while addressing parameter list. |
| CPF3C1E E | Required parameter &1 omitted. |
| 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. |
| CPFBB4D E | Cluster Resource Services cannot process the request. |
| CPFBD09 E | Clustered hash table server &1 not active or not responding. |
| CPFBD0A E | Clustered hash table server &1 internal error. |
API Introduced: V5R2
[ Back to top | Cluster APIs | APIs by category ]