TACL Reference Manual

Built-In Functions and Variables
HP NonStop TACL Reference Manual—429513-018
9-82
#CREATEFILE Built-In Function
If a logical volume is specified in the file name for file creation, the physical
volume on which the file is created is chosen by the system. The physical-
volume parameter overrides this selection.
The PHYSICALVOLUME option should be used only if no physical volume is
specified in file-name. Otherwise, a file-system error is returned.
Result
#CREATEFILE returns zero if it is successful; otherwise, it returns a file-system error
indicating the reason for the failure.
Considerations
•
If you specify only the volume for the filename, a temporary file is created on
the specified volume. You should also specify the FILENAMEV to retrieve the
temporary file name.
•
The PHYSICALVOLUME option should be used only if a logical volume was
specified for the filename. Otherwise a file-system error is returned.
•
If the system does not support the PHYSICALVOLUME option, error 561 is
returned.
•
Various failures on a system with a DSM/Storage Manager might result in the
inaccessibility of a logical file.
Example
#CREATEFILE /EXTENT 2,PHYSICALVOLUME $mg/ $v.a.b
Specifies that logical file, $v.s.f, be created with a two-page extent size on physical
volume $mg.