User guide

Guardian Procedures
HP NonStop Storage Management Foundation User's Guide—523562-007
8-19
SMS_GETSTGPOOLHDR_
Syntax for C Programmers
SMS_GETSTGPOOLHDR_
The SMS_GETSTGPOOLHDR_ procedure retrieves configuration information for a
particular storage pool
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.
pool-name:pool-name-length input:input
STRING .EXT:ref:*, INT:value
specifies the name and size of the buffer containing the name of a storage pool
process. The storage pool can reside on a local or remote node. If no system
name, is provided, the current default system is used.
pool-config-buffer:pool-config-buffer-max-length output:input
STRING .EXT:ref:*, INT:value
specifies the name and size of the buffer to which configuration information should
be returned. If pool-config-buffer-max-length is smaller than 74 bytes, an
error is returned. The information returned to the pool-config-buffer is
described under Pool Configuration Buffer on page 8-5.
pool-config-buffer-out-length output
INT .EXT:ref:*
is the number of bytes of configuration information returned. If an error value other
than FEOK (zero) is returned, this value is set to zero, and the contents of pool-
config-buffer are undefined.
#include <cextdecs(SMS_GETPOOLSSTART_)>
short SMS_GETPOOLSSTART_
( [char *system-name
,short system-name-length]
);
error := SMS_GETSTGPOOLHDR_
(,pool-name:pool-name-length ! i:i
,pool-config-buffer:pool-config-buffer-max-length ! o:i
,pool-config-buffer-out-length ! o
)CALLABLE, EXTENSIBLE;