STRCHTSVR (Start Clustered Hash Table Server)

STRCHTSVR Command syntax diagram

 

Purpose

The Start Clustered Hash Table Server (STRCHTSVR) command is used to start a clustered hash table server on each cluster node specified in the NODE parameter. Successful completion of this command results in a job started on each node defined in the cluster. Each node specified in the NODE parameter will be in the clustered hash table server domain.

The clustered hash table server enables sharing and replicating data between cluster nodes using the Clustered Hash Table APIs. The data is stored within the clustered hash table server in non-persistent storage.

Use the End Clustered Hash Table Server (ENDCHTSVR) command to end the clustered hash table server.

Restrictions

• Cluster Resource Service must be active on the local node.
• All nodes specified in the NODE parameter must have Cluster Resource Services active.
• Requesting user profile must exist on all nodes specified in the NODE parameter.
• Requesting user must have *CHANGE authority to the authorization list, if specified, on the current node as well as all nodes specified in the NODE parameter.

 

Required Parameters

SERVER

Specifies the clustered hash table server to be started.

server-name: Specify the name of the clustered hash table server to be started.

 

Optional Parameters

RSPTIMO

Specifies the amount of time (in seconds) that the clustered hash table server has to complete a retrieve request. An error will be returned to the requestor of the retrieve if the clustered hash table server does not get a response before the specified length of time. This parameter is ignored when the current cluster version is 3 or greater.

60: The clustered hash table server will wait 60 seconds for a response.

response-timeout-value: Specify the amount of time (in seconds) the clustered hash table server waits for a response before returning an error. Valid values range from 1 through 300 seconds.

AUTL

Specifies an authorization list name for the clustered hash table server. This defines the list of users authorized to start, end and connect to the clustered hash table server. An authorization list by the same name must exist on all nodes in the NODE parameter. The same authorization list name must be specified when starting a clustered hash table server that is already running on other nodes in the cluster.

*SERVER: Use the same authorization list as the specified clustered hash table server if it is already active on one of the nodes in the cluster. If the server does not exist in the cluster and this value is specified then no special authority will be needed to access, start, end, or connect to the server. This value must be specified if the current cluster version is 2 or less .

authorization-list-name: The name specified defines the list of users authorized to the clustered hash table server. Users must have *CHANGE authority to the named authorization list to start and end the clustered hash table server. Users must have *USE authority to the named authorization list to connect to the clustered hash table server. Management of the authorization list is the users responsibility.

NODE

Specifies the list of cluster nodes that compose the clustered hash table domain. A server job will be started on each of the cluster nodes specified. If the clustered hash table server already exists in the cluster, the cluster nodes specified will be added to the clustered hash table domain and a job will be started on the node specified. Nodes in this list must be unique. The nodes must be active in the cluster.

*LOCAL: A clustered hash table server will be started on the local node only. *LOCAL can be specified only once.

node-identifier: Specify the name of each cluster node that defines the clustered hash table domain. Up to 128 cluster nodes can be specified.>

Examples for STRCHTSVR

Example 1: Starting a local clustered hash table server

STRCHTSVR  SERVER(CHTSVR1)

This command starts clustered hash table server CHTSVR1 only on the local node. There is no authority restriction on the clustered hash table server.

Example 2: Starting a clustered hash table server on multiple nodes

STRCHTSVR  SERVER(CHTSVR2)  AUTL(AUTHLIST) NODE(FRED BARNEY)

This command starts clustered hash table server CHTSVR2 on nodes FRED and BARNEY. The clustered hash table server has access restricted by AUTHLIST.

Error messages for STRCHTSVR

*ESCAPE Messages

CPFBD02

Start Clustered Hash Table Server failed with reason code &1.