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 ]