User guide

Guardian Procedures
HP NonStop Storage Management Foundation User's Guide—523562-007
8-15
SMS_GETPOOLOFVOLUME_
Syntax for C Programmers
SMS_GETPOOLOFVOLUME_
The SMS_GETPOOLOFVOLUME_ procedure retrieves the name of the storage pool
with which a particular physical volume is associated
error returned value
INT
indicates the outcome of the operation. If an error occurs, a file system error
number is returned. If no error occurs, FEOK (zero) is returned.
vol-name:vol-name-length input:input
STRING .EXT:ref:*, INT:value
specifies the name and size of the buffer containing the name of a physical
volume. The physical volume can reside on a local or remote node. If no system
name is specified, the current default system is used.
pool-name:pool-name-max-length output:input
STRING .EXT:ref:*, INT:value
specifies the name and size of the buffer to which to return the name of the storage
pool. The name returned is fully qualified. If pool-name-max-length is too
small, an error is returned.
pool-name-out-length output
INT .EXT:ref:*
is set to the number of bytes in the storage pool name returned if an error value of
FEOK (zero) is returned. If an error value other than FEOK (zero) is returned, this
value is set to zero, and the contents of pool-name are undefined.
#include <cextdecs(SMS_GETPHYSVOLSINPOOLSTART_)>
short SMS_GETPHYSVOLSINPOOLSTART_
( char *pool-name
,short pool-name-length
,[short *vol-type]
);
error := SMS_GETPOOLOFVOLUME_
(,vol-name:vol-name-length ! i:i
,pool-name:pool-name-max-length ! o:i
,pool-name-out-length ! o
)CALLABLE, EXTENSIBLE;