getDefaultClusterNames

Returns the default names the clustering software would assign for a given pool name. Before calling the addPool command with the cluster element, you should call this command to acquire the suggested default names for the clustering parameters. Then pass the values returned by getDefaultClusterNames as input element values to the addPool command.

Request

<getDefaultClusterNames>
   <poolName/>
</getDefaultClusterNames>

Reply

<getDefaultClusterNames>
   <poolName/>
   <ndsName/>
   <virtualServerName/>
   <cifsVirtualServerName/>
   <result value=" ">
      <description/>
   </result>
</getDefaultClusterNames>

Elements

poolName: Specifies the NSS storage pool name for which default names are to be returned. The named pool does not need to exist.
ndsName: Specifies the suggested default name for the pool's eDirectory object.
virtualServerName: Specifies the suggested default name for the pool's virtual server eDirectory object.
cifsVirtualServerName: Specifies the suggested default name for the pool's CIFS virtual server (that's used in advertising on the CIFS protocol).
result: Specifies an error value or 0 (for no error).
description: Specifies a text description of the result.

Example

The following is an example of calling getDefaultClusterNames on the "ibm_cluster" server on the "MYPOOL" pool:

<nssRequest>
   <pool>
      <getDefaultClusterNames>
         <poolName>MYPOOL</poolName>
      </getDefaultClusterNames>
   </pool>
</nssRequest>

A nssReply packet to the get default cluster names command follows:

<nssReply>
   <pool>
      <getDefaultClusterNames>
         <poolName>MYPOOL</poolName>
         <ndsName>ibm_cluster_MYPOOL_POOL</ndsName>
         <virtualServerName>
            ibm_cluster_MYPOOL_SERVER
         </virtualServerName>
         <cifsVirtualServerName>
            ibm_clust_MYPOO
         </cifsVirtualServerName>
         <result value="0">
            <description/>success</description>
         </result>
      </getDefaultClusterNames>
   </pool>

   <result value="0">
      <description/>zOK</description>
   </result>
</nssReply>