beautypg.com

Sms_getstgpoolhdr, Syntax for c programmers sms_getstgpoolhdr – HP NonStop G-Series User Manual

Page 131

background image

Guardian Procedures

HP NonStop Storage Management Foundation User's Guide523562-008

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