beautypg.com

Sms_getpoolofvolume, Syntax for c programmers sms_getpoolofvolume – HP NonStop G-Series User Manual

Page 127

background image

Guardian Procedures

HP NonStop Storage Management Foundation User's Guide523562-008

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
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;