HP Integrity NonStop J-Series User Manual
Page 124
Guardian Procedures
HP NonStop Storage Management Foundation User's Guide—523562-007
8-12
SMS_GETPHYSVOLSINPOOLNEXT_
volumes associated with the storage pool. After your final call to this procedure, call
SMS_GETPHYSVOLSINPOOLEND_ 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 lengths of supplied buffer parameters are set to
zero, and the contents of the buffers are undefined. If no error occurs, FEOK (zero)
is returned. A value of FEEOF (one) indicates that information for the last physical
volume associated with the storage pool has already been retrieved.
vol-name:vol-name-max-length
output:input
STRING .EXT:ref:*, INT:value
specifies the name and size of the buffer to which the physical volume name
should be returned. If the buffer is not large enough to hold the physical volume
name, including the name of the system on which it resides, an error is returned.
vol-name-out-length
output
INT .EXT:ref:*
is set to the number of bytes in the physical volume name 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
vol-name
are undefined.
vol-type
output
INT .EXT:ref:*
is a flag whose fifteenth bit position will be set to 1 if the volume is magnetic. By
default, information for all types of volumes is returned.
vol-config-buffer:vol-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 the buffer is not large enough to hold the information, an error is
returned; this error is retryable.
error := SMS_GETPHYSVOLSINPOOLNEXT_
(,vol-name:vol-name-max-length ! o:i
,vol-name-out-length ! o
,[vol-type] ! o
,[vol-config-buffer:vol-config-buffer-max-length ! o:i
, vol-config-buffer-out-length] ! o
,[vol-status-buffer:vol-status-buffer-max-length ! o:i
, vol-status-buffer-out-length] ! o
)CALLABLE, EXTENSIBLE;