User guide

Guardian Procedures
HP NonStop Storage Management Foundation User's Guide—523562-007
8-21
SMS_GETVIRTDISKSNEXT_
to discover multiple virtual disks associated with a storage pool. After your final call to
this procedure, call SMS_GETVIRTDISKSEND_ to terminate your retrieval session.
error returned value
INT
indicates the outcome of the operation. If an error occurs, a file system error
number is returned, the output length of the supplied buffer parameter is set to
zero, and the contents of the buffer are undefined. If no error occurs, FEOK (zero)
is returned. A value of FEEOF (one) indicates that information for the last storage
pool on the system has already been processed.
virt-disk-name:virt-disk-name-max-length output:input
STRING .EXT:ref:*, INT:value
specifies the name and size of the buffer to which the virtual disk name should be
returned. If the buffer is not large enough to hold the name, including the name of
the system on which the virtual disk resides, an error is returned.
virt-disk-name-out-length output
INT .EXT:ref:*
is the number of bytes in the virtual disk name. If an error value other than FEOK
(zero) is returned, this value is set to zero and the contents of virt-disk-name
are undefined.
virt-disk-config-buffer:
virt-disk-config-buffer-max-length output:input
STRING .EXT:ref:*, INT:value
specifies the name and size of the buffer to which information about the virtual disk
should be returned. If the buffer is not large enough to hold the information, an
error is returned; this error is retryable. The virt-disk-config-buffer should
be at least 116 bytes long.
The information returned might not reflect the actual current status. SMF might
have processed status change notifications from subsystems on which it depends
after constructing the reply.
The information returned to the virt-disk-config-buffer is described under
Virtual Disk Configuration Buffer
on page 8-7.
error := SMS_GETVIRTDISKSNEXT_
(,virt-disk-name:virt-disk-name-max-length ! o:i
,virt-disk-name-out-length ! o
,[virt-disk-config-buffer:
virt-disk-config-buffer-max-length ! o:i
, virt-disk-config-buffer-out-length] ! o
)CALLABLE, EXTENSIBLE;