getState

Retrieves the current state of an existing NSS storage pool. This command is implemented only on NetWare and not on Linux.

Request

<getState>
   <poolName/>
</getState>

Reply

<getState>
   <poolName/>
   <poolState/>
   <result value=" ">
      <description/>
   </result>
</getState>

Elements

poolName

Specifies the name of an existing NSS storage pool for which to return the state.

poolState

Specifies the state of an NSS storage pool:

active
deactive
maintenance

result

Specifies an error value or 0 (for no error).

description

Specifies a text description of the result.

Example

A nssRequest packet to returns the state is as follows:

<nssRequest>
   <pool>
      <getState>
         <poolName>SYS</poolName>
      </getState>
   </pool>
</nssRequet>

A nssReply packet to the get state command follows:

<nssReply>
   <pool>
      <getState>
         <poolName>SYS</poolName>
         <poolState>active</poolState>
         <result value="0">
            <description/>success</description>
         </result>
      </getState>
   </pool>

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