beautypg.com

Sms_relocatefile, Syntax for c programmers sms_relocatefile – HP NonStop G-Series User Manual

Page 136

background image

Guardian Procedures

HP NonStop Storage Management Foundation User's Guide523562-008

8-24

SMS_RELOCATEFILE_

The information returned to the

virt-disk-config-buffer

is described under

Virtual Disk Configuration Buffer

on page 8-7.

virt-disk-config-buffer-out-length

output

INT .EXT:ref:*

is the number of bytes of information copied into the configuration buffer.

Syntax for C Programmers

SMS_RELOCATEFILE_

The SMS_RELOCATEFILE_ procedure changes the physical volume on which a
virtual disk file resides. Any file to be moved cannot be open when you call this
procedure. You must own the file to be moved or must be a member of the super-
group (255,n).

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.

logical-file-name:logical-file-name-length

input:input

STRING .EXT:ref:*, INT:value

specifies the name and size of the buffer containing the name of the logical disk file
to be relocated.

#include
short SMS_GETVIRTUALDISKHDR_
( char *virt-disk-name
,short virt-disk-name-length
,char *virt-disk-config-buffer
,short virt-disk-config-buffer-max-length
short virt-disk-config-buffer-out-length
);

error := SMS_RELOCATEFILE_
(logical-file-name:logical-file-name-length ! i:i
,old-phys-filename:old-phys-filename-length ! i:i
,[new-volume-name:new-volume-name-length ] ! i:i
,[new-volume-options] ! i
,[relocation-priority] ! i
,[error-info-buffer:error-info-buffer-max-length ! o:i
,error-info-buffer-out-length] ! o
)CALLABLE, EXTENSIBLE;